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Electronics Starter Guide (Page 18). 

If you’re already a master hacker, don’t worry: 
we have something massive for you this month... 

AIY Projects is back with a bang, and Google SEE PAGE 30 FOR DETAILS 
has revealed to us its new Vision Kit (Page 6). 
Think ‘Google Clips made from cardboard’. 

Inside is a new Vision Bonnet that adds an 
artificial intelligence chip to the Raspberry THIS MONTH: 
Pi, making the Raspberry Pi 60 times faster at 
vision processing. It also enables you to control 
electronic components with AI. 

(Remember: ‘Don’t do evil with your Raspberry 
Pi’.) Seriously though: it’s an amazing piece of kit 18 ELECTRONICS STARTER GUIDE 
ave bia cone alate ne ae Oke Get started with components, kits, and circuits 

I wish you all a Merry Christmas and a Hacky New 
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1/27 FEATURE 


PROJECTS 


VISION KIT 


Google AIY Projects team reveals do-it-yourself Pi Zero W intelligent camera 


oogle AIY Projects has 

announced its Vision Kit, 

a smart camera kit you can 
build using a Pi Zero W, Pi Camera, 
Module, and a powerful AI board 
called the ‘Vision Bonnet’. 

Keen Google fans will recognise 
the similarity between the Vision 


THE VISION BONNET 
pec port . aa . 


The Pi Camera Module is 
connected directly to the 
Vision Kit bonnet 
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Kit and Google Clips, a recently “We look at how do we get 

announced smart camera. these technologies in people’s 
The Vision Kit enables makers hands in ways that are easy,” 

to build a similar device, but that’s says Jess Holbrook, ATY Projects 

just the start.AIY Projects is all UX Research Lead. 

about developing hackable AI kits “AI and machine learning are 

for makers that they can integrate up on this pedestal,” he explains. 


into their own projects. 


Google wants to show makers that 


Movidius MA2450 


The beating heart of 
the Vision Bonnet, this 


powerful VPU chip makes 
the Pi Zero W 60 times 
faster at vision processing 


GPIO breakout pins 


The Vision Bonnet has six 
GPIO breakout pins, enabling —: 
you to integrate the kit with tye a si 


your own hardware projects 
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they can build pretty impressive 
stuff themselves. As with earlier 
AIY Projects, Google is interested 
to see what ideas makers come up 
with to use AI to “solve problems 
for themselves, their families, 
and their communities.” 


oO 
Y 


“We have developed a deep 
learning inference acceleration 
engine that we’re running on the 
chip,” explains Kai Yick from the 


AIY Projects team. “It’s 60 times 


faster than trying to doitona 
Raspberry Pi 3.” 


The Vision Kit adds an 
advanced AI hardware 
board to the Raspberry P1 


All aboard Al 

The Vision Kit adds an 
advanced AI hardware board 
to the Raspberry Pi. Developed 
by Google, it’s called the 
Vision Bonnet and sports a 
powerful Movidius MA2450 
(movidius.com/myriadx) 
vision processing chip. 

The chip acts as a “neural 
network accelerator” says Billy 
Rutledge, Director of AIY Projects 
at Google. “In the case of Vision 
Kit, we are moving forward ina 
pretty big leap and running the Al 
neural network on the accessory 
board itself.” 

This is in contrast to the earlier 
AIY Projects Voice Kit, which relied 
on Google Cloud infrastructure 
for voice recognition and natural 
language processing. 
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The projects you build will 
operate independently of a 
network connection, making for a 
more versatile piece of equipment. 
The Vision Bonnet also ensures 
the security of captured images, 
as they are all processed locally 
on the device. 


Kit form 

Once you’ve assembled the Vision 
Kit, there are a number of neural 
networks software programs you 


can run. The first neural network is 


a “person, cat, and dog detector,” 
reveals Peter Malkin, Software 
Lead at AIY Projects. It detects if a 
person, cat, or dog is in the frame. 

The second neural network is 
focused on facial emotions. It will 
detect happiness, sadness, and 
other sentiments. 


The third neural network can 
identify 1,001 common objects, 
like a cup, an orange, or a chair. 

A label displays the name, and the 
level of confidence in the neural 
network’s inference. 

In the future, the hope is that 
users will be able to modify these 
neural networks. You could take 
the cat, dog, and person model and 
modify it to look for rabbits. Then 
build a project that works witha 
rabbit hutch, for instance. 

Both The MagPi and Google can’t 
wait to see what makers have in 
store for the AIY Projects Vision 
Kit. Pre-orders for the Vision kit 
will begin in December at Micro 
Center (microcenter.com). 


= a 


News 


ORDER DEC 


The AIY Projects 
Vision Kit will 

be available for 
pre-order from 
Micro Center in 
December 2017. 
The initial run 

is going to be 
very limited. If 
you're interested, 
we advise 

you to order 

a kit as soon 

as it’s available. 
microcenter.com 


Below The Vision 

Kit is a smart 
camera project 
used to detect 
faces, moods, and 
objects; you can 
build it at home and 
integrate it with your 
own projects 
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cottish firm Curious Chip 

has unveiled Pip, “the 

playful handheld device 
you program yourself.” Pip has 
been launched on Kickstarter, with 
a modest £50,000 target — see 
kck.st/2yAEc4gh. A £150 pledge 
bags you a Pip, while £200 nets you 
a Pip, camera, and maker pack. 
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» HACKABLE 
~ HANDHELD 


Make apps, play games, hack anything 


With final-version prototypes to 
play with, Raspberry Pi co-founder 
Eben Upton has given his backing: 
“Tm super-excited about this! ’'m 
really, really looking forward to 
seeing what people do [with a Pip].” 

Pip’s D-pad and buttons are 
mounted on two detachable USB 
controllers — however, Jason 
Frame, co-founder and technical 
lead for Pip, tells us, “We came 
up with the removable controller 
idea... a full two weeks before 
[a certain handheld game console 


was announced]”. Two shoulder 
buttons are housed in the 
main body. 

Pip also includes a row of eight 
RGB LEDs and a 40-pin GPIO 
ribbon cable connector either 
side of its 4-inch, 800 x 480 pixel 
touchscreen. There’s a speaker, 
microphone, accelerometer, 
and compass, as well as two 
USB ports, HDMI out, wireless, 
and an optional 5MP camera. 

Pip is powered by a Raspberry Pi 
Compute Module 3 Lite. 


Above Pip is more than a games 
console - it's a mobile makers’ lab 
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Made for making 
Pip might look like a portable 
games console, and indeed it 
comes preloaded with “a number 
of open-source remakes of popular 
games like Pac-Man and Super 
Bomberman,” according to Jason. 
However, he adds, “What we 
really want is for kids — and 
adults! — to go beyond that: make 
stuff and share it with the world. 
Games, apps, physical stuff, 
everywhere and anywhere.” Pip 
was made with making in mind. 
“All we wanted to do,” Jason 
continues, “was make a portable 
device that you could have your 


A portable device that you can have your own 
code running on in less than five minutes 


own code running on in less than 
five minutes.” 

To this end, Pip has its own 
IDE, called Curiosity. “It’s hosted 
on Pip itself,” Jason reveals, “so 
there’s nothing to install.” You 
can create software for Pip on any 
machine with a web browser. 

“Curiosity offers one ‘mode’ 
for each language supported by 
Pip: JavaScript, Python, Lua, and 
PHP+HTML5,” Jason explains. 
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“There are built in libraries for 
games coding that simplify stuff 
like drawing, collision, particle 
systems, and even shader effects.” 

You can emulate your code in 
the browser, and “it’s just one 
click” to send your code to Pip 
wirelessly. For young coders, 
there’s a visual coding app called 
Livewire. Jason confirms , “We’ve 
been iterating [Livewire] for five 
years now.” 


Unusually, Pip uses a Compute Module 3 (CM3) 
rather than a Raspberry Pi 3. But Curious Chip didn't 
know what would power Pip in the early days of 
development. “The CM3 Lite edition (with SD card 
support) was announced shortly before Pip v1 
debuted at Bett 2017 [a trade show for education 
technology] and immediately we gave it a serious 
look,” Jason tells us. 

You can see the resultant motherboard to 
the left, with the CM3 slot (which the Raspberry 
Pi Foundation borrowed from laptop SODIMM 
memory) in the centre. 

Asked whether the use of CM3 gave Pipa 
possible upgrade option, Jason responds, “Size 
was the main concern... The smaller a device is, the 
more likely you are to take it with you and the more 
to can do with it." He adds,"Pip should have enough 
juice for our expected use-cases for a good while 
to come. Isn't a quad-core, credit-card-sized SoC 
with 1GB RAM enough for anybody?” 


Make 
apps, games, and 
other software 
with Pip's built-in 
development tool 


Lin 
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THE FIRST AUTONOMOUS COMPANY? 


Coffee for the masses 


University of Edinburgh 

project might just be the 

first fully autonomous 
business. The Pi- powered BitBarista 
accepts BitCoin payments to 
dispense coffee, pays users to 
restock supplies, and will calla 
technician should a fault occur. 

BitBarista is not some glorified 

kettle with WiFi, though. Using 
the BitCoin from coffee sales, 
BitBarista “pays people for small 
services such as filling its water 
tank and replenishing it with 


The technology is advanced, 


BitBarista pays people for small teens 
services such as filling its water tank Bee ee eee on 
and replenishing it with coffee beans 


were created.” 


Raspberry Pi and coffee 


coffee beans,” according to Dr for Design Informatics, The Pi controlling BitBarista uses 
Larissa Pschetz, Programme University of Edinburgh and Raspbian “and different plug-ins 
Director of Product Design co-creator of BitBarista. to simplify tasks and connect 
and Researcher at the Centre When coffee stocks run low, things together,” Larissa reveals. 
BitBarista asks the user to select “We also use Electrum for the 
a restock vendor. These options BitCoin payments.” The code is on 
could be ranked in price order, GitHub, at magpi.cc/21VHXKI. 
or by ethical preference. Larissa BitBarista might be useful for 
explains, “I was also intrigued other vending machines, but 
by this idea of an autonomous Larissa warns, “The machine still 
coffee machine that would reduce needs to follow the social rules of 
intermediaries in the coffee trade, the context where it is placed. If 
potentially supporting smallholder __ people think it is inappropriate 
famers in developing countries.” they will probably turn it off.” 
BitBarista is currently ona Asked whether there were 
long-term trial throughout the machines where BitBarista 
UK, “which is revealing reactions technology might not ever be 
to the machine’s autonomous appropriate, Larissa replies, “Of 
features,” according toa University course there is always space for 
of Edinburgh spokesperson. malicious practices, but people are 
So far, Larissa has seen that careful and good at figuring these 
EET Ee aera nee Reem ee ee aed eee “some rituals such as making things out so it wouldn’t last in the 
would you choose the cheapest, or the most ethical? coffee for colleagues were lost long term.” 
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Raspberry Pi for professional applications 


Og 


SU QUO 


Strato Pi enhances the Raspberry Pi and the Compute 
Module with hardware features that make them 
Suitable for use in professional applications where 
reliability and service continuity are key requirements. 
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Grab the latest magazine from 
the Raspberry Pi Foundation 
and get hacking! 


Introducing HackSpace magazine 


he Raspberry Pi Foundation 

has launched a new 

magazine aimed at makers, 
hackers, and tinkerers. Following 
on from the success of The MagPi - 
The Official Raspberry Pi magazine 
and its education-focused sister 
mag Hello World comes HackSpace 
magazine (hsmag.cc). 

This monthly title is all about 
hacking and making. As Features 
Editor Andrew Gregory says, 

“Grab some duct tape, fire up the 
microcontroller, ready a 3D printer, 
and hack the world around you!” 

HackSpace magazine features 
tutorials and projects covering 


a huge range of topics. Just like 
The MagPi, HackSpace magazine 
is written by the community for 
the community, so get in touch 
if you’ve got a great project you 
would like to share, or if you 
want to see more coverage of 
certain topics. 

Copies of HackSpace magazine 
will be in UK newsagents from 
23 November, and you can 
download a free PDF version. 
Subscriptions start from just £2.50 
a month if you already subscribe 
to The MagPi. 

Follow HackSpace magazine 
on Twitter @HackSpaceMag. 
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Neatly mount multiple Pi 
devices on a DIN rail DINrPlate 
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Neatly arrange Pi clusters on a DIN rail 


INrPlate offers a neat way 

to mount many Pi devices 

together in a small space by 
attaching them all toa35mm DIN 
rail, the same mount that modern 
fuse boxes use. 

The first DINrPlates were 
launched toward the end of 2015 
for full-sized Raspberry Pi devices, 
but there’s a new range for Pi Zero 
and Arduino units. Kurt Baum, 
President of DINrPlate, tells us: 
“The incredible success of the Pi 
and support behind it has made it 
the de facto development system 
for other industrial applications as 


well... the DINrPlate fills the need 
to securely mount the Raspberry Pi 
in an industrial environment.” 

The unit is made of tough Nylon 
6/6 plastic, onto which you screw 
the Pi using the supplied screws. 
Unlike other DIN cases which 
enclose the Pi, DINrPlate’s “open- 
frame design keeps the Pis running 
cooler under heavy workloads,” 
according to Kurt. The tab is 
DINrPlate’s “strain relief system to 
protect the power cable from being 
accidentally unplugged.” 

The DINrPlate Zero costs £10 
from modmypi.com. 


DINrPlate 
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GET CODING 


Install Python modules in seconds with piwheels 


i Foundation Community 

Manager Ben Nuttall has 

released piwheels, a set of 
pre-compiled Python modules that 
reduces the install time from tens 
of minutes to a couple of seconds. 

Pip is the best way to install 

Python packages, as it grabs the 
very latest version. However, 
often these packages “have been 


of packages for common hardware 
and software combinations. 
However, until Ben’s project, 
there were no wheels for a Pi 
running Raspbian. 

Enter Ben with his epic project 
to pre-compile all 750,000 
wheels for the Raspberry Pi. 

With some help from SQL expert 
Dave Jones (@waveform80), and 


Pip 1s the best way to install 
Python packages, as 1t grabs 
the very latest version. 


implemented in C and require 
compilation,” Ben explains. 
Compilation takes ages, however 
— installing the NumPy package 
ona Pi3 can take over 20 minutes. 
The Python community solved 
this problem a while back with 
‘wheels’, pre-compiled versions 


az 
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the Raspberry Pi Foundation’s 
web host Mythic Beasts 
(mythic-beasts.com), there 
are now over 670,000 wheels 
for more than 96,000 packages. 
NumPy now installs in seconds 
using the command sudo pip3 
install numpy. 
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Any suggestions or errors should be logged 
on the GitHub project page: magpi.cc/2iWg1GV 
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magpi.cc/2LHZWsS 


Allo's £95 DigiOne ‘audio transport’ HAT has made a 
few waves online, claiming that its low jitter of 0.6 ps 
and noise of 50 uV make it superior to many high-end 
audio setups. 


magpi.cc/2lZ11N3 


PiBorg's latest robot kit is well named. Its four 300rpm 
motors, ThunderBorg motor controller, ‘massive’ 
105mm wheels, and chunky 3mm-thick aluminium 
casing wouldn't look out of place on a battlefield. 


magpi.cc/2LMmybw 


Rolls-Royce has joined with Formula Pi to offer coders 
the chance to ‘Race Your Code: Successful applicants 
had the opportunity to race ‘autonomous, Raspberry Pi- 
powered robots around a track’ from 20 Nov to 7 Dec. 


December 2017 cig?! 


Image credit: Phillip Burgess, learn.adafruit.com/assets/46754 


Phillip’s script includes ways to disable read-only mode, 
by use of ajumper or quick button connect 


Cluster HAT handles the hardware 


new version of the 

Cluster HAT - allowing 

you connect up to four 
Raspberry Pi Zeros in a cluster 


— is on sale from ModMyPi for 


y UN 
yr o * 


Right The new 
Cluster HAT V2 has 
an improved layout 
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Adafruit script for ‘make and forget’ Pi builds 


f you’ve ever built a Pi for 

a kiosk, installation or 

information display, you’ ll 
find Adafruit’s read-only Pi script 
invaluable. This script disables all 
the write-to-SD-card functions, 
meaning that you can pull the 
plug without any risk of data loss 
or corruption. 

The Adafruit script forces 
Raspbian to store all its temporary 
data in memory, so no data 
stored on the SD card can be 
corrupted. This also means that 
nothing at all can be written 
to the SD card. 


£28, or for £90 with four Zeros 
and four 16GB microSD cards 
(see magpi.cc/2iW]mxkK). 

We liked the V1.2 ClusterHAT 
back in The MagPi #55, and this 
new model refines the design. 
ModMyPi Director Jacob Marsh 
explains, “The V2 has an improved 


layout and utilises an I?C I/O 


expander — essentially it means 
the controller can be rebooted 
without affecting the Pi Zeros, and 
the power to each Pi Zero can be 
controlled individually.” 


Script author, and Adafruit 
Creative Engineer, Phillip Burgess 
tells us, “We’re seeing Raspberry 
Pi really take off in situations 
where a microcontroller may 
have once sufficed,” and points 
out that less technical users are 
making things with a Raspberry Pi. 
Phillip wanted the ability to simply 
cut power like one does with an 
Arduino or a consumer product. 

The script only works on 
Lite installations — “Stretch or 
Jessie should work,” Phillip tells 
us — and you can find the full 
instructions at magpi.cc/2hB7qMT. 


Above Build a cutting-edge cluster 
computer in minutes 

There are also a few new 
headerless jumpers (which look 
like solder pads). For example, 
the POS jumper on the underside 
can be cut to force the Pi Zeros 
to power up with the host Pi. 

The affordable Cluster HAT 
opens the door to anyone wanting 
to experiment with distributed 
computing techniques commonly 
used in data centres or when 
analysing big data. 
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PI-CONTROLLED ECO HOME BAGS PRESTIGIOUS U.S. PRIZE 


News 


PI-CONTROLLED ECO HOME 
BAGS PRESTIGIOUS US PRIZE 


Swiss team wins US Department of Energy’s ‘Solar Decathlon’ 


team of engineering students has won the 
annual Solar Decathlon, which challenges 
teams to “design and build a full-size, 
solar-powered house” and is run by the US 
Department of Energy (DoE). 

The Swiss team’s NeighborHub project scored 
872.91 out of 1000, with perfect scores for the 
architecture, engineering, and energy challenges 
(and 95 points or more in four other challenges). 
This clearly met the DoE’s brief of being “the team 
that best blends design excellence and smart energy 
production with innovation, market potential, and 
energy and water efficiency.” 

The NeighborHub design uses four prefabricated 
‘core’ modules to provide a kitchen, bathroom, 
bedroom, and closets; around this is the ‘Extended 
Skin’, a semi-exterior area that resembles a glazed 
cloister. The Swiss team’s brief for the technology was 
that “actuators are able to communicate to each other 
and operate together to reach optimal performance” 
and also to enable “sharing through a learning-by- 
doing approach.” 

Swiss team engineering lead Victor Saadé tells us 
that telecommunication student and team member 
Florian Meyer “basically designed the whole house 
control system,” in partnership with Swiss team 
sponsor ThinkEE (thinkee.com). It was the flexibility 
of the Pi that appealed; the team used three Pi 3s 
in the final build: one running a database, another 
running “all the algorithms”, and a third acting 
as a router. 

You can read more about the NeighborHub 
at magpli.cc/2iWrTsg. 


The Swiss team used three 
Pi 3s, each with its own 
complicated task 
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Image credit: Swiss Living Challenge 
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GoPiGo 


20+ new projects for your Pi robot car. 
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pi-top 


Inspiring inventors and creators to PS RASPBERRY PI 
ee 

seek the skills of tomorrow and 

create their future, today. OCR 


= pi-top 


pi-tapCODER 


Colors 
Raspberry Pi 3 optional 


ance AWESOME INVENTOR’S KIT INCLUDED 


20+ projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular laptop. 


The modular laptop with sliding keyboard 


Gi : 
ey @ ie) all Get started with 20+ inventions in the inventor's 


guide booklet. There are 3 inventor's journeys - 


SHR BATTERY 14” FULL HD 180 CUSTOM MODULAR 
LIFE 1080P SCREEN HINGE PASSIVE COOLING RAIL Smart Robot, Music Maker and Space Raco. 
BRIDGE 


pi-topCEED 


Colors Ma 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We’ve put what you love 
about our flagship laptop in a slimmer 


form factor. Join hundreds of code clubs 


The modular desktop and classrooms using pi-topCEED as 


IEy " their solution to Computer Science and 
Ele STEAM-based Learning. 
14” FULL HD MODULAR ADJUSTABLE 
1080P SCREEN RAIL VIEWING ANGLES 


,. 
teaee 
sayy 


Modular 
Accessories 


teuens 
OCTET ETTA Ae 


sane 
feet 


pi-topPROTO pi-topSPEAKER pi-topPULSE 


© www.pi-top.com © @GetPiTop i /GetPiTop Stay up to date with our Latest news by following our social media 


pi-top is an award-winning ecosystem designed to make 
experimenting, coding and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR* endorsed pi-topOS (Operating system) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 
Learning Lesson plans with pi-topCODER and have fun 
Learning to code with CEEDuniverse! 


pm topOASHBOARO 


CEEDuniverse 
4? H ; 


pi-topCODER has a fully 
integrated coding environment 
letting you program hardware 
code in Python and Learn Lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you Learn 


CEEDuniverse 


Learn programming concepts 
through our minigames, 
for example, learn problem 


decomposition by solving 
visual programming puzzles. 
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LECTRONICS 
STARTER GUIDE 


Hands-on with circuits, tl cle and Bubs computing 
using a Raspberry Pi computer BCM2837 


s well as being the best- WHY LE ARN : 
mower, BASIC ELECTRONICS? & 


LL Oo 
: aeai AUS 


around, the Raspberry Pi is the | as 
A bill of materials i | ft Se ee ae Do you want to be just a user duct tape. But prototyping your | BS 
(or ‘BOM’) is : ee on, § By BY de ae of gadgets? Or do you want to own circuits, and making your at 
ainsuativerts a ut al hee lo 5 i AREA be a maker, hacker, and a fixer? own circuit boards, and learning = 
pornitneccits ' P Somebody who knows what is how to connect components | F3 
; and attach electronic components going on under the surface, who together is a vital part of the aue 
etn | like LED lights, buzzers, buttons, knows how to fix, adapt, and maker process. a5 
cepa . a eet Fe ota et ok improve the world around them. The modern world is infused se 
arava (itislise | ag tas se no ae Kg 2 The Raspberry Pi isn't just a with electronic devices, and the 
hebiotelertronic ' Bleak, ce és HE es i lian cheap, incredibly well-made ae is going ag be built on | 
Pomponents ' o ee air Ro aw computer. It helps you to learn apneeny Meugen ecuoule 
eer are 4 es ia Oe Ae oe, about how computers work. devices. So it's incredibly 
aeeallntiones 4 eh Wee P 8 Of course, there are many important to understand how 
| PINS) YOMICae elements to making. There is these things work. Learning the 
turn a Raspberry Pi into just learning to code, and how to use basics of circuit building will help 
about anything. maker tools like 3D printers and you navigate the future. 


This feature is for those who 
want to know how to build, hack, 
and make with computers. In this 
noua Nemes Welcome to the wondertul 
schematics, prototype circuits 


 crohilal bein dabiteiwedntcc world of electronics with 
Welcome to the wonderful world ; 
a Raspberry Pi 


of electronics with Raspberry Pi. 


WHAT IS A HAT? 


2200 ~HATs (Hardware Attached on Top) are pre-built circuit boards with 


‘i 
age 
ii components and parts. They are designed to connect to the 40- 

pin GPIO header on your Raspberry Pi, and are easy to set up and 

eet started. HATs offer a friction-free way to use electronics, and 

some (like the Pimoroni Explorer HAT, magpi.cc/10AKy46) add 

a breadboard to your Raspberry Pi. For this feature, we’ll eschew 


HATs and focus on using pure electronics connected directly 


al _ tothe Raspberry Pi GPIO pins. 
1005 
| ; zo | ic gi oe ' 
a pe C10 Paling 18:2mHz4 en 


tte gaye 18 === 16 : 
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VDDIO2_1 


VDDIO2_2 


PROTOTYPING 


td an 
OWT: ; 


ereisa teal ee Pi and breadboard 
project. Wires from the Raspberry Pi are 

connected to circuit components. Code on the i 
Pi is used to control the circuit. 


The GPIO pins on a Raspberry Pi are used to get input ia 
from components, such as a button being pushed 


= 


he 
or the value from a sensor. They can also be set to ee 
send output, and turned on or off (set to ‘HIGH’ and Bi, 
‘LOW’) to control components. i a 


t ; 
? Ly 
pete 


Jumper leads are used to connect the Raspberry Pi 
GPIO pins to components on the breadboard (and to 
hook up components to each other). 


A breadboard is used to create a prototype of a circuit. [7 
Components are placed into the holes on the board, 
and jumper leads are used to connect them to each 
other (and to the Raspberry Pi GPIO pins). 


These come in all shapes and sizes and perform a Pah: 


wide variety of tasks. Common components include 
LEDs, resistors, potentiometers, PIR sensors, 
and switches. 
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STARTER GUIDE 


It's common to buy kits containing a variety of 
components. The parts can be used with Raspberry Pi 
resources and other tutorial guides 


There are two CamJam 
Edukit electronics packs 
available from The Pi Hut 
(magpi.cc/2yV1VQY). 
The first (£5) contains 

a breadboard, LEDs, 
buttons, and buzzers. 
The second (£8) also 

has temperature and 

PIR sensors. Both come 


with jumper wires and 
downloadable worksheets 
for you to follow. 


Simon Monk is a popular 
writer of electronics 
guides (he's written 
several guides for /he 
MagP)). His starter kit 
(magpi.cc/2eCgB5jz, ey 
£10/$17) has all 
manner of parts and a 
ten projects to create. 


This pack from ModMyPi 
(magpi.cc/2mjJJdB, £16) 
contains a transparent 
breadboard (so you can 
see the connections 
inside). It also has 

LEDs resistors, 

buttons, buzzers, 
sensors, and jumper 
wires. It's one of the 
more comprehensive 
kits and comes with 


a complete range of 
YouTube videos to help you 
work with each component 
(magpi.cc/2jjoftf). 
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KIT YOULL NEED 


Handy kit you need to start learning electronics with a Raspberry Pi 


BREADBOARD 


A breadboard is a plastic slab witha 
bunch of holes in it. At first glance, 
it looks pretty unfathomable, but it 
soon becomes easy to understand. 
See our How To Use a Breadboard 
tutorial (magpi.cc/2jB52Vz). We 
use a Raspberry Pi Breadboard 
(Half Size) in our diagrams 
(magpi.cc/2q34ZFz). 


Terminal strips 


In the middle of the breadboard 
are (typically two) columns of 


holes, called terminal strips. These 
are typically arranged in rows of 


five, and each hole in a group of 
five is connected to the one next 
to it. Components placed into a 
row of five holes are connected 
to each other. So you can connect 
circuit components to each other 
without having to physically wire 
them together. 


Power rails 


Down each side of the breadboard 
are two rows of holes (running all 
the way along the board). These are 
positive and negative rails and are 
typically connected to a battery, 

or the power (3v3/5V) and ground 
(GND) pins on a Raspberry Pi. 


DIP support 


In the centre of a breadboard, between the 

two columns of terminal strips, is a gap. This is 
usually the exact size to place a DIP (dualin-line 
package) chip. These IC chips can straddle the 
central division with a row of pins falling into 
holes on either side. 


wr 
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JUMPER LEADS 


Jumper leads are used 
to connect the GPIO 
pins on a Raspberry Pi 


If you’re 
absolutely new 
to electronics 


RESISTORS 


LEDs are delicate little 
things. If you put too much 
current through them, they 


to the components on on a Raspberry will pop (sometimes quite 5V 
your breadboard. Some By Pi, then buya spectacularly). To limit the il 
jumper leads have female bunch of LEDs _ current going through the +4 
eee: ends that connect to ‘and resistors | LED, you should always use a Ri 
the GPIO pins on the _ (along with your _ resistor in series with it. The ‘a 
Ey Raspberry Pi, and male H breadboard and | resistor can be anything over | 10 


ends that connect to the 


jumper leads). These 


about 500hms. 


MF-MsMF2e60%x) holes on a breadboard. enable you to set up a simple | magpi.cc/2mtKKjs yr 

; wa er" 
a Typically you’ ll needa ! circuit that lights up an LED KE id 
Pa selection of female-to- with code, like the one in 10 
EP male and male-to-male this online tutorial: Physical 

_ jumper leads. 2 Computing with Python. . 
magpi.cc/2muhzg4 magpi.cc/2mjGMJZ Ps = 
L “ 
. 7 R3 
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READING 
RESISTORS 


9V BATTERY SNAP 


Your Raspberry Pi outputs 

a steady 3.3V from some 

of its GPIO pins and it’s 
perfectly possible to get by 
without a battery. But we 
find a9V battery with a snap 
cable a handy way to add 
power to a circuit and test 
out components. 


< magpi.cc/2mshkSG 
a3 


PUSH BUTTON 


A push button is a great way to 
test out input on a Raspberry 
Pi (where you create code that 
responds to physical button 
pushes). Some push buttons 
have two pins; others — like 
this one — have four pins and 
are designed to fit across the 
DIP support bridge at the 
centre of a breadboard. 
mMagpi.cc/2mqTgj2 


i 
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C1 

PIR SENSOR 

A PIR (passive infrared) sensor 

is used to detect motion. a 

Alongside buttons, they are 

a good way to add input toa 

project. You can create a Script 


PIEZOELECTRIC 


that detects movement and 
respondsaccordingly, jo [PE ssececcccccmsmencs 
magpi.cc/2msRLkJ SPEAKER 


This buzzer is used to add 
basic sound to a project. While 
it’s not going to rock the 
house, a piezoelectric speaker 
is a handy way to get feedback 
from a project. 
Magpi.cc/2muqlIFy 


The ultrasonic distance sensor can determine how 
far it is from a solid object. It works by sending out 


a burst of ultrasound. 
This sound will travel 
i through air but 
35 reflect back (echo) 


off hard surfaces. The 
sensor detects the 
echo. They’re often 
5 found on robots and 
other Raspberry 
iad Pi projects. 
=) magpi.cc/2mtgpS1 
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Use the colour bars on a resistor to read its values. 
One of the ends will have a stripe on it, typically silver 
or gold. Make sure that is on the right. Now look 
closely at the bands in the middle, 


The first two bands represent numbers and the 


third is a multiplier. In the resistor below, we have two 
orange (3) bands and a brown (10) multiplier. So our 
resistor is 33 x10, or 3300hms). The final gold band 
shows that it has a tolerance, or precision, for the 


resistor. Ours is 5%. 


Band 1: | 
Number 


QRANGE: 
3 


YELLOW: 


Band 2: Band 3: 


Number 


QRANGE: 

3 1000 

YELLOW: YELLOW: 
10000 


GREEN: 
100000 


BLUE: 
1000000 


GOLD: 
0.1 


SILVER: 
0.01 


Multiplier 


QRANGE: 


Band 4: | 


Tolerance 


BROWN: 
1% 


RED: 
2% 


GOLD: 
0% 


SILVER: 
10% 


NOTHING: 
20% 
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WIRING 
AND 


nce you’ve got a breadboard There are two approaches to and similar ones used by the 
and some electronic describing the layout of electrical Raspberry Pi Foundation and other 
components, you’llwantto circuits. The first is to use a wiring — resources. If you’re interested 
start wiring them up and learning diagram (see ‘Wiring diagram’ ). in creating your own, you use a 
how they work with a Raspberry Pi. The simple circuit shown below program called Fritzing to make 
There’s absolutely no shortage connects a push button and them (fritzing.org). 
of electronic projects out there, LED to separate GPIO pins ona If you want a guide to GPIO 
and most of them guide you Raspberry Pi. The Raspberry Pi pins and acrash course in 
through attaching components detects a button push and lights controlling them with GPIO Zero, 
to your breadboard, then using up the LED. take a look at our Beginner’s 
software such as the GPIO Zero You’ ll find wiring diagrams Guide to GPIO Zero in The MagPi 
es Python library. like this throughout The MagPi, issue 52 (magpi.cc/Issue-52). 
tT Tifs 
=i! 
Hs rie 
“C10 ay a] 19-2MHZ Ci 
= Fs EE RAY Jumper leads are Follow the lines of holes on 
; me Fe | represented by these the breadboard to see how 
< coloured wires e components are connected » 
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Components 


The components are visually similar to real- 
life counterparts. Some, like the LED, visually 


lo V U 


demonstrate which way around they should go 


L7o bi 1 70 arn ¥ 
i 1005 |3_} 1005 OO 
| aa 
a4 | GPIog — = > @PIo14 | 2 ( raspberrypi.org/magpi 
Py | GPIO1 GPIO15 AS 7 
RAC } GPIO3 GPIO17 ltTny 
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SCHEMATIC DIAGRAM 


The GPIO pins of a Raspberry 


Raspberry Pi 1; ~ Pi are represented by this 


on | large rectangle. They are 
I 
not in the same positions 


as the physical pins on the 


, 
GPIO2 SDA1 12C GPIO21 


real board 


GPIO3 SCL1 12C GPIO20 
GPIO4 GPIO16 
GPIO17 GPIO12 


GPIO27 


Components are 


GP1022 GPIO7 SPIO_CE1_N represented by abstract 


D 
Red (633nm) 


GIPO10 SPIO_MOSI GPIO8 SPIO_CEO N symbols, like this triangle 


with arrows (which 


GPIO11 SPIO_SCLK GPIO24 represents an LED) 
ID_SD 12C ID EEPROM GPIO23 


GPIO9 SPIO_MISO GPIO25 


GPIO5 GPIO18 PCM_CLK 


GPIO6 GPIO15 UARTO_RXD Black lines are used to 


GPIO13 GPIO14 UARTO_TXD indicate connections 


GPIO19 between components on the 


GPIO26 


circuit. These can represent 
jumper wires or components 
connected to the same rail 
ona breadboard 


HOWTO: UNDERSTAND =| *™ 
SCHEMATIC DIAGRAMS 


>STEP-O1 » 
Components R | 
Schematics describe how components are connected. 
Unlike wiring diagrams, symbols aren’t visually +5 % 
similar to.their real-world components and the KK 330 2 
schematic isn’t necessarily visually accurate. It’s a 
euide to how things are connected. 

Take the resistor. Instead of being a visually realistic 
tube with coloured rings, it is indicated by these zigzag 


1V8 


UIN 
BCM28¢ 


XTALE 


lines (we’re using the US-style resistor symbol in this D 1 
feature, in the UK it’s often a square rectangle). The 
properties are often listed alongside as text. Learning Red (633nm) 


to identify components is half the battle. Take a look 

at the ‘Component reference guide’ (page 25), which 

compares symbols with their real-world counterparts. = STEP-02 
| Connections 


R 1 Now we’ ve added a second component to our resistor, 
an LED. This is represented by a triangle (the symbol 
a 5 Y for a diode, it indicates that flow can only travel in 
= one direction). The LED symbol also has two arrows 
3 30 C) pointing outwards, representing light being emitted. 


We join the two components together with a single 

2 black line. This indicates that they are connected (on 
our prototype breadboard they could be in the same 
row of holes, or connected with a jumper lead). 
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Red (633mm) 
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>STEP-03 

Integrated circuits 

Our Raspberry Pi is displayed as an IC (integrated 
circuit) box. This large rectangle has pins all around 
it representing the pins on the GPIO header. We’ve 
connected our resistor and LED to GPIO 17 (as written 
inside the IC box). Like other components, the IC 
schematic is an abstraction and doesn’t resemble 
the physical layout of the pins. Use a pin guide 
(pinout.xyz) to locate the physical pins on your 
Raspberry Pi board 


D1 
Red (633nm) 


>STEP-04 

Wires and nodes 

Sometimes, wires form a junction that connects 
multiple components together. Our button is ona 
separate GPIO pin to the LED and resistor, but both 
join together and connect to a single ground pin. 
Wires connecting at a junction are indicated by large 
circles called ‘nodes’. When you see this circle, it 
means wires in the circuit connect at this point. 
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4D 1 
>STEP-05 


Crossed wires 

In a well-designed schematic, parts will be kept 
separate and wires will not cross each other. This isn’t 
always possible with more complex schematics, and 
sometimes designs just aren’t as clear as they could 
be. If you see two wires crossing each other without a 
node circle, that means the wires are just passing by 
(and aren’t connected). . 


DI 
Red (633nm) 


>STEP-06 

Reference designator 

Now that you know how to identify wires and 
components on the schematic, you simply need 

to identify each component and the order they are 
connected in. Component names are normally a 
letter and a number. So your first resistor is R1, the 
second one R2, and so on. You can view a list of all 
the common reference designators on Wikipedia 
(magpi.cc/2mqvyUf). Happy prototyping. 
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Here are some common 
components along with their 
reference designator letter and 

RE F E RE | \ | C E is | | IL) E both visual wiring graphic and 
schematic diagram. 


Reference Wiring Schematic 
Component | designator image symbol 


2 ee eee ee 


GG @@@ & 
U GU UL UU 


Resistor 


_ 
Diode (LED) 
Anode nS f Cathode 


Transistor Q 


Schematic symbols courtesy of Wikipeda.org 
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a 19} BCM2837 
7. 7s al tl sy 
= = The GPIO pin positions on the schematic diagram 
| OS OS don't match those on the physical board. Use 
gS: ~ pinout.xyz if you need guidance on the pin position 
HGPIOO =" VGPIO14 Fa 


feature 


MAKE A 


GPIO MUSIC BOX 


This project shows you how to wire up buttons to your Raspberry Pi’s GPIO 


pins and then use them to play sounds with a simple Python application 


n this tutorial, we’ll use several push 
buttons to make a GPIO music box that 
triggers different sounds when we press 
different buttons. 

For this, we’ll make use of GPIO Zero’s Button 
class to assign sound samples to buttons. While we 
have provided a wiring diagram, we suggest you try 
following the schematic first, using your new-found 
knowledge. If this proves troublesome, check the 
schematic against the wiring diagram. 


>STEP-O1 

Get some sounds 

} Before we start building our GPIO music box circuit, 
we’ll need to prepare some sound samples for it to 
play. First, open a Terminal window and create a 

® directory called musicbox for this project. Then create 
a directory called samples within musicbox. 

We need to source some sound samples. While there 
are many public domain sounds to be found online, 
for this example we’ ll use some of Scratch’s built-in 
percussion sounds, already present on the Pi. Copy the 
Scratch percussion sounds to the samples directory. 


‘eb 
NE 
en 


Raspberry Pi 
Breadboard 


4 x Tactile 
switches to 
make buttons 


5 x Male-to- 
female jumper 
leads 


4 x Male-to-male 
jumper leads 


mkdir musicbox 

mkdir musicbox/samples 

cp /usr/share/scratch/Media/Sounds/ 
Percussion/* /home/pi/musicbox/samples 


>STEP-02 

Add a button 

Now follow the schematic and wire up the first button. 
Place the button so it straddles the central groove of 


Remember, the switches are not wired to each 
other. This junction points out that both are 


ebotel | connected to a single ground pin 


wa WN lg 
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WIRING DIAGRAM 


Try to wire up the circuit using the schematic 
below. If you find it difficult to follow, check this 
diagram. More instructions are on the Raspberry 
Pi resources website (magpi.cc/2z44wrC) 


GPIO MUSIC BOX SCHEMATIC 


Raspberry Pi 3 
Model Evl2 
1 SE Lee ) FEPROM 


rly SPI CE) 
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‘>STEP-04 


Each time you press a button, the assigned sound sample will 
play through a connected: speaker 


Extra buttons can easily be added to the circuit to play more 
sounds assigned in the Python code 
the breadboard. One leg is connected to the GPIO 2 
pin, and the other to the common ground rail on the 
breadboard, which in turn is wired to aGND pin. 


>STEP-03 


Now add a second button to the circuit, again 
following the schematic. Place it on the breadboard 
as before, and wire it up to GPIO 3 and the common 
eround rail. 

Now open a new file in Python 3 IDLE, enter 
the code from gpio_musicbox. py, and save it in 
your musicbox folder. Run the program and push 
the buttons. You should hear a noise with each 
button push. 


The way we have structured the program makes it 
easy to add extra buttons and assign them to sound 
samples. Just connect each button to a GPIO number 


pin (not any other type) and the ground rail, as before. 


Then add the GPIO pin numbers and sounds to the 
dictionary, as in the following example: 


sound pins = { 
2: Sound("samples/DrumBizz. oti 
3: Sound("samples/CymbalCrash.wav"), 
4: Sound("samples/Gong.wav") , 
14: Sound("samples/HandClap.wav"), 


Add more buttons and redraw the schematic with 
switches connected to the Raspberry Pi IC. 


raspberrypi.org/ magpi 


STARTER GUIDE 


SL SS = = ee ae 


pygame.mixer DOWNLOAD: 

pygame.mixer Sound magpi.cc/2BaGLLM 
gpiozero Button 
Signal pause 

pygame.mixer.init() 

button _sounds = { 
Button(2): Sound( Ne 
Button(3): Sound( Ve 
Button(4): Sound( ), 
Button(14): Sound( ), 


button, sound button _sounds.items(): 
button.when_pressed = sound.play 


pause( ) 
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MAKE A 


RANGE-FINDER 


Link together an ultrasonic distance sensor and seven-segment display 


to measure distances 


it api 


distance sensor which are quite cool in a retro kind of way. 
magpi.cc/ 


2mtgpS1 >STE P-01 
Lighting the display 


Broadcom 5082- 
7650 7-segment 


9 x Resistors 
(7 x 220Q, 


The HC-SR04 ultrasonic distance sensor 
is displayed as an IC with four pins 


Fuaptrenre Fi 3 
Mel BE 1 


he HC-SRo4 ultrasonic distance sensor is a 
ereat favourite with Pi robot-makers. It works 
by bouncing ultrasonic sound off an object and 
NEEV timing how long it takes for the echo to return. This 
a time is then converted into a distance which can be 
displayed on a single-digit, seven-segment display. 
HC-SRo4 Here you can acquire the skills to handle inputs and 
ultrasonic outputs. You also get to use seven-segment displays, 


The seven-segment display is a collection of LEDs, 
display with one LED corresponding to one of the segments. 
magpi.cc/ _ All the anodes (positive ends) are connected together; 
1Y¥nqQPL _ this should be connected to the 3.3 V power (3V3 pin). 
The cathodes (negative ends) should be connected to a 
resistor to limit the LED current and the other end of 
4x 512Q, 1x 1kQ) the resistor to aGPIO pin. To turn the LED on, all you 
magpi.cc/ | have to do is set the GPIO output to be LOW (OV) and it 
aYnqUir will complete the circuit for the current to flow. 


You can use any seven-segment display, but 


alternatives might have a different pinout 


Ultrasonic distance sensor: gives out a pulse 


proportional to any reflecting object in front of it 


>STEP-02 

Generating a seven-segment pattern » 

The display consists of four bars or segments that can 
be lit. By choosing the segments to light up, you can 
display a number from 0 to 15, although you have to 
resort to letters (also known as hexadecimal numbers) 
for this. There are, in fact, 128 different patterns you 
can make, but most are meaningless. In our code 
(range_finder.py), a list called seg defines which pins 
are connected to which segments, and another list 
called segmentPattern defines the LED pattern for 
each number. 


Remember that two points crossing are not 
linked unless there's a large circular node. 

On this schematic, the lines are coloured 
differently to help guide the ‘ratsnest’ of wires 
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a 


The project in action; the Pi is measuring how far it is 
to the Raspberry Pi 3 box 


>STEP-03 


The display function sets up the segments to 
display any single-digit number passed to it. First, 
it sets all the segments to off, and then if the 
number is less than 16, it goes through the entries 
in the segmentPattern list for that number and 
turns on the appropriate segments. Note that we 
can still use on and of f even though they’re not 
powered by individual GPIO pins, as the LEDs were 
declared to GPIO Zero as active_high = False. 


>STEP-04 


The HC-SRo4 distance sensor signals its reading 
by producing an output pulse that the Pi tries to 
measure. The GPIO Zero library measures this 
pulse and converts it into a distance by returning a 
floating-point number that maxes out at 1 metre. 
We then multiply this number by 10 to give 
decimetres. Next, we convert it to an integer to get 


rid of the fractional part of the measurement, so we 


can show it on our single-digit display. 
>STEP-05 


For this build, we used a dinky little breadboard 
shield from Dtronixs. This allowed for a much 
more compact arrangement than a conventional 
breadboard, although you can of course still use 
one. As the HC-SRo4 uses a5V power supply, the 
pulse we have to measure is also nominally 5V. 
Therefore, this has to be cut down to 3.3V by using 
a 5120, and1kQ resistor voltage divider. 
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STARTER GUIDE 


aus 


display 
Q2. gpiozero LED 
Q3. gpiozero DistanceSensor 
Q4. time 


Q6. seg REED G27. lse),LED(25, 
False),LED(24, False), 

Q7. LED(23, False),LED(22, 
False),LED(18, False), 

Q8. BED CL; False) ] 

Oo 


10. segmentPattern 
) hp =) 6 | y ale Zz 3 6 | ) [ 0, 2, 3 A 5 ) 6 | ) #0 to 5 


»[0,1,2,5,6],[0,1,2,4,5,6], #6 to A 


SF Aeon; Olly, ||| Gages oll viel oe OlAE, 


de 

14. sensor = DistanceSensor(15,4) 

5% 

16. def main() : 

17. print( ) 

18. 

19; ile 

20. distance = sensor.distance * 10 # distance in 
decimeters 

2 print( , distance) 

222 distance ).0: 

23) distance 16.0 

2a. display(int(distance) ) 

25. time.sleep(@.8) 

26. 

27. def display( yi: 

28. i range(@,7): 

29. seg[i].off() 

30. number St: 

ole i range(0, len(segmentPattern[ number |) ): 

BiPLs seg[segmentPattern[ number |[i]].on() 

Bh? 


34. # Main program logic: 


a . =z >| ms . 
T= “ 
i 
ae eS 


a 


The distance to the reflective object is updated every m 
0.8 seconds. If this is greater than a metre, then the 
display will be blank. A display of 0 indicates that the 
object is less than 10cm away. Don’t touch the sensor, il ie 
otherwise its readings will be wrong. Also, as it has 
quite a wide beam, you can get reflections from the 
side. If several objects are in the field of view, then the 
distance to the closest one is returned. 
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DOWNLOAD: 
magpi.cc/2BaGLLM 


Q1. # displays the distance in decimetres on a 7-segment 
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Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 


Free Pi Zero W case with three covers 
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Free Camera Module connector 
Free USB and HDMI converter cables 
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Save up to 25% on the price 


Free delivery to your door 


Exclusive Pi offers and discounts 


Get every issue first (before stores) 
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CLOTHING 


Mart Drake-Knight and his brother Rob have put dozens of Raspberry Pis 
at the heart of their super-efficient clothing factory 


>» Rapanui's 
factory plugs 
into the Internet 
of Things 


» All workstations 
and machinery 
are Pi-powered 


>» The UI has 
been made 
mistake-proof 


>» IBM's Node- 
RED is free and 
open source 


» Fire destroyed 
the previous 
factory in 2016 


hen brothers Rob and Mart 

Drake-Knight struggled 

like mad to find a job in 
2008, they could so easily have 
reached a point where they would 
have to sell the shirts off their 
backs. Luckily they decided to spend 
£200 setting up an environmental 
clothing company on the Isle of 
Wight instead, growing it froma 
garden shed to a large factory ina 
former Co-op supermarket. 

Today, the whole operation at 

Rapanui is powered by renewable 
energy and a creative, hackathon, 


DIY spirit. More specifically, it also 
makes use of nearly 100 Raspberry 
Pis to perform many different 
tasks. “Some are connected to 
sensors or machinery that we’ve 
made in our machine shop,” says 
Mart. “Some do simple stuff like 
open windows and help people 
solve problems.” 

Other Pis drive touchscreens 
and workstations and they 
enable staff to prioritise work. 
Put together, they have made 
Rapanui’s manufacturing process 
very efficient while allowing the 


firm’s eco-friendly and sustainable 
clothing to be affordable. By 
automating the dull parts of the 
job and giving managers a solid 
overview of what’s happening in 
the factory and where, Rapanui 
can go as far as offering tailored 
services: you could get the 
company to make a single T-shirt 
with your picture or logo or order 
1,000. Either way, you could have 
the garment the following day. 

In order to bring the technology in 
the factory together, Rapanui uses a 
lightweight messaging protocol for 


This Arduino robotic 
arm is an experiment 
to see if tasks can be 


delegated to it 


An Echo Dot is also 
connected so workers 
can verbally ask the 
robot to perform tasks 


Connected to a Pi 
receiving MQTT 
data, it listens to the 
instructions given to 
Pam and attempts to 
parallel-perform the 
same task 
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small sensors and mobile devices 
called MQTT and this allows the Pis 
to broadcast their behaviour to other 
machines or human interfaces. 
Using Node-RED, the hardware 
devices, APIs and online services are 
wired together. 

“We use Node-RED in live 
production to broadcast order data 
between two specific machines that 
are time-critical,” Mart tells us. 
“More recently we used Node-RED 
for cool stuff like joining an Alexa 
API to our factory systems so that 
you can ask the factory questions 
such as how many jobs are pending, 
which lets us direct staff to the 
areas where they are needed. It also 


controls some robotic equipment employees how to code though time production systems which Running 
Rapanui's factory 


-_ , —— _ i Se 


we’re working on.” programming apprenticeships. allows products to be made in the ere arinia 
; ; “The Pi has given usagreat way — seconds after they are ordered. business, hence 
Creating tech jobs to build confidence at the early “The breakthrough has massively eas ee 
The firm has since built on that screens at this 
Syston Ole ou cere emcee The whole operation is powered J “™™™en"" 
which lets users create an online 
store, sell T-shirts, and take the by renewable energy and a 
profits of each sale. “People can oe 
join and access the API directly via Cle alive, hackathon, DIY Splrit 
Teemill,” Mart says. But just as 
importantly, Rapanui’s approach stage in people who want to start reduced waste and cost,” Mart tells 
to the development of its clothes a career with us in computing,” us. “And since we’ve doubled in 
has created desirable tech jobs continues Mart. Indeed, today size every year and the Raspberry 
on the Isle of Wight, with the the company invests a lot of its Pis are modular, they have scaled 
company able to show its young time developing automated, real- with us.” 


| 
>STEP-01 >STEP-02 >STEP-03 
Creating an order Printing the T-shirt Sending it out 
A customer can create any product The lights change colour, alerting workers When the T-shirt is ready, Pam scans 
they like at Teemill.com. When a to the location of the next task. The and packs it. The interface tracks her 
T-shirt is ordered, Holly picks the order. workstation interfaces broadcast the work, broadcasting the status back to 
The Pi runs the interfaces, which are machine's status to the MQTT broker, the systems. The customer is notified 
connected via Node-RED/MQTT. which is run centrally on a Pi. that the order is on its way. 
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> The project 
requires lots 
of drilling and 
woodwork 


> The camera's 
housing is 
made in two 
connecting 
parts 


> It uses OpenCV 
- acomputer 
vision software 
library 


> The camera's 
object 
detection is 
better at lower 
angles 


» Aaron and 
Davis list 
their other 
projects at 
hackerhouse. 
site 


Davis is picked up on camera 
thanks to OpenCV's object- 
recognition capability 


SECURITY 
CAMERA 


Be a Pi spy with Aaron Tainter and Davis Lau’s amazing camera 
that makes use of the open-source computer vision library OpenCV 


here are plenty of home 

security cameras currently 

on the market, many 
allowing you to stream live footage 
over the internet and receive alerts 
whenever someone wanders past. 
But rather than buy one of those, 
two makers, Aaron Tainter and 
Davis Lau, spied an opportunity. 
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Combining a Raspberry Pi Zero W, 
a Pi Camera Module, and the 
amazing OpenCV app, they decided 
to make their own. 

The inspiration to do so felt 
obvious. “We’re known for mixing 
artificial intelligence and computer 
vision with our DIY projects, so 
a Smart security system seemed 


Inside the housing is a Pi Zero W 
and a Pi Camera Module. A hole 
is cut for the power cord 


to align well with our genre,” 
explains Aaron. The pair have 
previously created numerous 
home-automation projects, ranging 
from an indoor gardener to a 
smartphone-connected door lock. “I 
think our security camera resonates 
with people. The object-recognition 
part is really fascinating.” 


The camera is mounted using 
a 90-degree angle bracket 
fixed to the wall with outdoor 
mounting tape 
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OpenCV (opencv.org) makes 
adding computer vision to Pi 
projects rather straightforward. 

It allows you to train the Raspberry 
Pi to identify objects and react to 
them, which is perfect given that 
Aaron and Davis wanted their smart 
security camera to feature facial 
and body detection. The plan was 
for the camera to send an email 
notification whenever it detects 
someone, although it can be set 

up to stream live video through a 
webcam Server too. 

“We also wanted to add a servo- 
gimbal so that you could tilt and 


One drawback is that the camera 

can only recognise one object at a time 

Fortunately, writing the code for 
the web app proved easier and they 
were thankful OpenCV exists and 
could (after a staggering eight hours) 
be installed on the Pi Zero. “Without 
OpenCV, the project wouldn’t have 
been possible,” Aaron explains. 
“Tt contains thousands of lines of 
code that were written over the 
course of many years and it gives 
individual developers like us the 
chance to produce something 
awesome without years of research 
and development.” 


I think our security camera 
resonates with people 


pan the camera from the web 

app,” says Aaron. “But because we 
typically give ourselves a month 

to complete a project like this and 
have to film and edit the build 
videos for our YouTube channel, 

by the time we finished building the 
camera body we didn’t have enough 
time left for it.” 


Smart housing 

That seems a shame, but then 
building the camera’s MDF housing 
was a tricky process, with various 
holes needed in the right places 

to gain access to the Pi. “We also 
wanted to make the top removable 
so that the components were more 
accessible but compact enough that 
it could be mounted on a ceiling,” 
says Aaron, explaining that a CAD 
model was built first so that they 
could get the measurements just 
right when they cut the materials. 
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The pair still needed to tinker 
with it. “We had to make a few 
optimisations to get the camera 
working at a high frame rate because 
OpenCV eats up the CPU,” Aaron 
recalls. There was also an issue with 
the video feed being choppy, solved 
by parallelising a few processes 
in the code. But before long, the 
camera was allowing the viewing of 
live streams, detecting objects and 
sending any images it picked up on 
to a Gmail address. 

“The Raspberry Pi Zero is a 
ereat piece of hardware because it 
has a small form factor yet comes 
loaded with features,” says Aaron 
of the reason why it works so well 
in the camera. “It was the perfect 
platform to mount in a small case 
and run our image-recognition 
software. I’m surprised how much 
performance you can get out of that 
tiny computer.” 


en 


| nl a ee 


Build the housing 

After designing the housing and creating paper 
templates for guidance, a %4-inch (6mm) MDF board 
is cut to size. The pieces are then glued and screwed 
together before being sprayed black. 


£ 


>STEP-02 

Insert the bits 

The Pi Zero W and Pi Camera Module connect via an 
Adafruit Pi Zero Camera Cable. Future versions may 
contain a NoIR Pi Camera: “It’s supposed to have 
exceptional low-light capabilities.” 


>STEP-03 
Sending it out 
An MbientLab micro-USB to USB cable powers the 
device and OpenCV software is used. “I'd like to try 
different ‘image classifiers’ to recognise other objects 
like cats and dogs,” Aaron says. 


December 2017 MdgPi 35 


blocks with loops attached 


> It can draw any 
shape using x-y 
coordinates 


>» Dan took 
around a year 
to refine the 
software 


>The arm 
can also be 
controlled 
manually 


> It's powered by 
an original Pi 1 
Model B 


>» APCA9685 
board drives 
the arm's 
servos 
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With the ability to draw any shape, this robot arm is out of this world 


hand reaches out to a shiny 

gold box emblazoned with 

the NASA logo. At the 
press of a button, the connected 
robotic arm springs into life, 
lowering a blue Sharpie pen onto 
a paper pad to draw the circular 
outline of the famous logo, 
then an inner ‘spacecraft orbit’ 
ellipse, before switching to a red 
pen to sketch the red chevron 
(magpi.cc/2zHatI7). 

This is the Advanced Robotic 
Manipulator System Tools and 
Resources — or ‘ARM’ for short 
— built and programmed by Dan 
Gribok, a robotics intern at NASA’s 
Goddard Space Flight Center within 
the Satellite Servicing Projects 
Division. Designed to be used at 
outreach events to educate the 
public in what NASA is doing with 
robots, the Pi-powered ARM isa 
versatile device that can also be 
controlled manually using an Xbox 
gamepad to pick up objects using a 
hook or grabber. 


Art for events 

Dan tells us that the drawing 
ability came about from a need 

to have aconstantly running 
demonstration at events, such 

as this year’s Awesome Con in 
Washington DC. “So we wanted 

a demo where you could just push 
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a 
The six-axis robotic arm is an 
upgrade from the previous 
versions’ four-axis manipulator 


The manipulator arm tip can also 
be equipped with a hook to pick up 


Components inside the 
control box include an 
original Pi 1 Model B 


Each pen is held loosely ina 
tube, so the drawing pressure 
is provided by gravity 
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a button, step back, and everyone 
could watch all at once. And you 
can also give away a sheet of paper 
at the end and have them say, 
‘Hey, a robot drew this — how cool 
is that?” 

Asked about what ARM can draw, 
Dan says it depends on what he 
can program into it and what the 
hardware can actually replicate. 
He admits that the drawing action 
is a little jerky, which is due to 
the hardware itself: “There’s a 
lot of slop in the joints, a couple 


The force of gravity is used to 
eet the pen pressure right, as each 
Sharpie pen is held loosely ina 
tube. “We previously tried some 
other spring-like mechanisms, but 
we just settled on gravity drawing 
because it’s so much easier and it 
works perfectly fine.” 

So, what’s in the shiny control 
boxe Somewhat surprisingly, along 
with a PCA9685 °C servo controller 
and other components, the ARM 
uses an original Raspberry Pi1 
Model B — as did the two previous 


We wanted a demo where you 
could just push a button, step 
back, and everyone could watch 


of degrees, and some slop in the 
other mechanisms, which makes 
it really hard to draw [smooth] 
curved lines.” However, since 

it understands positions and 
coordinates, “Any line that you 
can express as x and y coordinates, 
so virtually anything, you can 
program into it and it’ll just follow 
that over and over.” 


versions of the project, which 
were based on OWI Edge robot 
manipulators. In autumn 2016, 
Dan was granted permission to 
upgrade the project’s robots: 
“T kept about half the internals of 
the control box and got completely 
new robot manipulators.” 

While the hardware setup was 
relatively straightforward, the 


BUILD A DRAWING ROBOT 


>STEP-01 
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>STEP-02 


NASA ARM 


Projects 


software took a lot longer. “The 
original robots were programmed 
in Python, but I noticed that we 
had performance issues, SO we 
switched entirely to C++.” After 
getting basic robotic functionality 
working by spring 2017, Dan 
made improvements over the 
summer, including adding the 
drawing capability. 


>STEP-03 


Above Pressing 
the button 

causes the arm 

to start drawing a 
preprogrammed 
sketch, in this case 
the NASA logo 
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Projects 


DASHBOARD OUT RUN 


‘of Combining two classics into one amazing racing project, Matt Brailsford 
: used a Raspberry Pi to build this incredible ’80s mash-up of racing toys 


ay back in 1983, aJapanese __ greatest, coolest racing game it with a modern screen. “T tried 
> The fuel gauge company called Tomy of all time: Out Run. quite a few [screens] trying to get 
re dene me created one of the most One maker, Matt Brailsford, one that would fit,” says Matt. His 
remaining remarkable toys of its generation: picked up a Tomy Turnin’ Turbo first attempt was a Screen that 
The turbo light Tomy Turnin’ Turbo Dashboard Dashboard on eBay and had a spark worked from the GPIO, but this left 
eomeconin was a driving simulator complete of genius: why not turnitintoafully few pins for all the other mods. 
high gear with gears, ignition, a working working Out Run arcade machine? “And the extra processing slowed 
» Asmall dashboard, a steering wheel, and Matt removed the original the game down.” 
vibrating motor even a looping display. display from the Tomy Turnin’ In the end, Matt used a KeDei 
er hapin Three years later, Sega released Turbo Dashboard and replaced 3.5-inch HDMI display (kedei.net). 
fasdhack arguably (well, we’d argue it) the 


> Matt tried 4 = 


four different Poe = tow , a 
screens before Is classic Tomy Turnin 


Fndi Dashboard is hacked into 
niche as a Sega arcade machine 
that fit 


> Matt hacked 
the speed to 
change it to 
mph from kph 


The screen displays an Out 
Run clone called Cannonball 


All of the controls and dashboard 


components are wired up to the 
Out Run game via a Raspberry Pi 
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TOMY TURNIN’ TURBO 


spear 


ity 


“eer 


Alot of components are carefully squeezed inside the original plastic case 


The original ignition key from 
the game was already wired as 
an SPST switch, so Matt wired 

INE MNO) WO ve Ivers oeiney 12, The 
manage the safe powering up 
and down, he used a PowerBlock 
(magpi.cc/2mLOf4P). “I simply 
hooked up the switch and installed 
the daemon to watch for the 
shutdown command and it all 
worked perfectly. A Picade PCB 
(magpi.cc/29DpDCz) was used to 


time and thinking things through, 
then trying things out.” 


Cannonball running 

You might be expecting the 
Raspberry Pi inside to be running 
an emulator like RetroPie, but 

no. It’s actually running an Out 
Run clone called Cannonball 
(magpi.cc/2mL3bAi1). Matt 
explains: “Cannonball is a C++ 
port of the original Out Run arcade 


Ultimately it was Just taking 
my time and thinking things 
through, then trying things out 


hook up the rest of the controls. 
Mike tells us it was “really easy to 
hook these up”, especially because 
the Picade PCB supports analogue 
controls for the steering wheel. 


Turn the key 

“There was a lot of luck involved 
as well,” explains Matt. “Lucky 
that the slide potentiometer 
happened to sit at the perfect 
height, lucky that there was 

just enough room for some 
microswitches to fit down the 
side of the gear shifter, and lucky 
I could balance the shifter rubber 


bands to keep the shifter centred... 


Ultimately it was just taking my 
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game and luckily ran perfectly on 
a Raspberry Pi 3. The reason I went 
with this rather than, for example, 
MAME is that it allowed me to 
change the core code and intercept 
the variables I wanted to use to 
update the dashboard. You could 
probably achieve something similar 
in MAME by inspecting the register 
values, but having access to the raw 
source code is way easier.” 

Matt tells us it’s fun to play. 
“Tt was a little squeaky to start with, 
but I had just tightened everything 
up a little too much. It runs nicely 
and brings back those memories 
as a kid. It’s how I thought it felt to 
play with back then.” 


DASHBOARD OUT RUN 


Projects 


~ HACKING 
A TOMY TURNIN’ 


i fe ae 


>STEP-01 


BPEEG 


GOo008 


>STEP-03 
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Tutorial 


Turn your web camera or Pi Camera Module into a stunning kaleidoscope 


> Webcam or 
Raspberry Pi 
Camera Module 


> Camera mount 
(optional) 


kaleidoscope is an age-old toy normally 

found in your Christmas stocking at least 

once in your life. Basically, it’s two mirrors 
set at an angle in a tube pointing at a collection of 
highly coloured blocks. By using a webcam, we can 
manipulate what it sees into a fascinating moving 
kaleidoscopic display on your Raspberry Pi. You can do 
this in real time at a good frame rate using a Pi 3 and 
a standard webcam; or, for a better-quality result, use 
the high-resolution Pi Camera Module. Figure 1 shows 
a Christmas-themed kaleidoscope image. 


Here's the live 


kaleidoscope image 


from the camera 


In this example we're 
using the Raspberry Pi 
Camera Module 


Optional camera support 
allows you to point the 
camera where you want 


The principle 
An eight-fold symmetry image can be created by a 
collection of simple horizontal and vertical flipping 
of segments of the image. These are fast for the 
computer to perform as they simply involve shifting 
bytes from one area of memory to another. Figures 2A 
and 2B (overleaf) show the steps we have to take in 
order to create this effect. First, the original image 
is duplicated and the duplicate is flipped vertically, 
producing an image with the same width but twice 
as high as the original. Then a triangular area is 
removed from each corner; this is done by filling the 
shape with a colour and making that colour the colour 
key, causing it to be transparent. This produces the 
basic quarter segment, which is duplicated three 
times — applying a horizontal flip and two rotations. 
Finally, these segments are all drawn together on the 
screen. They need to be shuffled a bit to fit snugly and 
eliminate lines on the joins. 

The image going into this process can itself be 
flipped or rotated to change the final pattern. Figure 3 
(overleaf) shows the results of doing this. 


A merry Christmas to you 


Original image Copy and flip 


Mask off half To produce a 


quarter segment 


Figure 2A Creating the symmetrical image (see also Figure 2B) 


The software 

We used the Pygame framework and the 
pygame.camera extension. The Pygame 
documentation warns that this interface might 
change, or indeed be removed in future versions. This 
will work with a compatible USB webcam — to check 
before you buy one, see magpi.cc/2yOgQsK. In order 
to make the Pi’s Camera Module compatible with this 
system, we need to enable the camera drivers in the 
menu Preferences > Raspberry Pi Configuration and 
reboot. Now you should type in the Kaleido_Cam.py 
program. There is a line in the software that makes 
sure the V4L2 drivers have been enabled as well. If you 
are typing in the program, note that in the line: 


os.system("sudo modprobe bcm2835-v412") 


...the end number should be lower-case V - four - 
lower-case L — two. 

The software makes use of what Pygame calls 
‘surfaces’. A surface is simply an area of memory that 
can hold a bitmap image. Surfaces are transferred to 
other surfaces by the use of the ‘blit’ operation, whose 
name harks back to the old days of computer graphics. 
The showScreen function is where all the heavy work 
takes place. First, it sees if the input image needs to 
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002. 
003. 


004. 
005. 


006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 


014 


015. 
016. 
017. 
018. 
019. 
020. 
921. 
022. 
023. 
024. 
925. 
626. 
027. 
628. 
929. 
030. 
931. 
032. 
933. 
034. 
935. 
036. 
037. 
038. 
939. 


040. 
041. 
042. 
043. 
044. 


045. 
046. 


047. 
048. 
049. 
050. 


haleido- Cam.py 


KALEIDO CAM 


>PYTHON 3 
import pygame, pygame.camera, os 


from tkinter import Tk 
from tkinter.filedialog import 
asksaveasfilename 


DOWNLOAD: 
magpi.cc/1NqJjmV 


PROJECT 
VIDEOS 


Check out Mike's 
Bakery videos at: 


os.system("sudo modprobe bcm2835- 
v412") # needed for Pi camera 
Tk() .withdraw() 

pygame.init() 

pygame. camera. init() 

os.environ[ 'SDL_VIDEO WINDOW _POS'] = ‘center’ 
pygame.display.set_caption("Kaleido Cam") 
pygame.event.set allowed(None) 

pygame.event.set allowed([pygame.KEYDOWN, pygame.QUIT |] ) 
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cs = 320 # basic image size 
cs2 = cs * 2 # window size 
screen = pygame.display.set mode([cs2,cs2],0,32) 


#find, open and start camera 

cam_ list = pygame.camera.list_cameras() 
print(pygame.camera.list_cameras()) 

webcam = pygame.camera.Camera(cam_list[@], (640,480) ) 
webcam.start() 

preRot = @ ; autoRotate = False 

savePath = '" 3; shotNumber = @ ; saveSource = False 
FflipH = False ; flipV = False 


def main(): 
while True: 
checkForEvent() 
showScreen() 
def showScreen(): #grab image, scale and blit to screen 
global camFrame, preRot 
camFrame = webcam.get image() 
if autoRotate : 
preRot += @.5 
if preRot > 360: 
preRot -= 360 
rotFrame = pygame.transform.scale(camFrame, (cS2,cSs2) ) 
# make square 
rotFrame = rot_center(rotFrame,preRot) # rotate 
sqFrame = pygame.Surface((cs,cs)) 
sqFrame.blit(rotFrame, (@,0),(cs//2,cs//2,cs,cs)) 
else : 
sqFrame = pygame.transform.scale(camFrame,(cs,cs)) # 
make square 
if flipV or flipH: # flip origional image option 
sqFrame = pygame.transform.flip(sqFrame, 
FlipH, flipV) 
# prepare master segment 
primary = pygame.Surface((cs,cs2)) 
primary.blit(sqFrame, (@,0)) 
primary.set_colorkey((@, 255, @)) 
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951. 


052. 
053. 
054. 
055. 


656. 


057. 
058. 
059. 
060. 


061. 
062. 
063. 
064. 


065. 
066. 
067. 
068. 
069. 
070. 


671. 
072. 
073. 
074. 
675. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 


085. 
086. 


087. 
088. 
089. 
690. 


991. 


092. 
993. 
994. 
995. 
696. 
097. 


primary2 = pygame.transform.flip(primary, 
False, True) 

primary2.blit(sqFrame, (0,0)) 

primary2.set_colorkey((@, 255, @)) 

# mask out part of image 

pygame.draw.polygon(primary2,(0,255,0), 
((0,cs),(cs,0),(0,0)),9) 

pygame.draw.polygon(primary2, (0,255,0), 
((8,cs),(cs,cs2),(0,cs2)),0) 

# draw master segment in various positions 

screen.fill((@, 0, @)) 

screen. blit(primary2, (cs-1,0)) 

primary = pygame.transform.flip(primary2, True, 
False) 

screen.blit(primary, (1,-1)) 

primary3 = pygame.transform.rotate(primary2, 90.0) 

screen.blit(primary3, (@,1)) 

primary3 = pygame.transform.rotate(primary2, 
-90.0) 

screen. blit(primary3, (@,cs-1)) 


pygame.display.update() # display screen 


def rot_center(image, angle): 
# rotate an image while keeping its center and 
size 
orig rect = image.get rect() 
rot_image = pygame.transform.rotate(image, angle) 
rot_rect = orig rect.copy() 
rot_rect.center = rot_image.get rect().center 
rot_image = rot_image.subsurface(rot_rect).copy() 
return rot_image 


def saveScreen(): 
global shotNumber, savePath 
if savePath == °" : 
savePath = asksaveasfilename( ) 
shotNumber = @ 
print("save path",savePath) 
rect = pygame.Rect(1,1,cs2-2,cs2-2) # remove black 
lines 
sub = screen.subsurface(rect) 
pygame.image.save(sub, 
SavePath+" “+str(shotNumber)+" . jpg") 
if saveSource: 
rect = pygame.Rect(0,0,640,480) 
sub = camFrame.subsurface(rect) 
pygame. image.save(sub, 


savePath+' “+str(shotNumber)+" source. jpg") 
print("saved as", savePath+" "+str(shotNumber )+". 
jpg") 


shotNumber +=1 


def terminate(): # close down the program 
webcam. stop() 
pygame.quit() # close pygame 
os._exit(1) 
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Generate four copies of segment 
each rotated by 90 degrees 


Combine four segments 


Figure 2B 


be flipped or rotated and then creates the symmetrical 
image we have described previously. The auto-rotation 
function might need a little explanation, however. 
When this is enabled, the rotation angle increments 
half a degree each frame. In order for the rotation to 
eventually produce an image of the correct dimensions 
as all the previous operations, we take a square image 
twice the size, rotate it around its centre, and then select 
a Square portion of it at the correct size. This means 

the resulting image is a bit zoomed in, to avoid blank 
sections at various rotation angles. The effect, however, 
is as if you were turning the kaleidoscope tube. 


Using the software 

The startup condition has no preprocessing on the 
input image. You can simply wave the camera around 
and see the results in real time. The RETURN key will 
save the kaleidoscope; the first time, it will prompt 
you for a folder and an initial name. Subsequent 
images will be saved using that name with number 
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Original image Flip Horizontal Flip Vertical Flip Horizontal & Vertical 


Rotate 45° Rotate 65° 


ee ate 


Figure 3 Input image manipulations 


postfix, which increments with each frame. Pressing e98. 
the S key will allow you to change the folder and root @99. def checkForEvent(): # see if we need to quit 
name, as well as resetting the postfix number. The O 100. global savePath, autoRotate, 
key will toggle the option of saving the original image saveSource, preRot, flipH, flipV 
along with the kaleidoscope image. The keys H and V 101. event = pygame.event.poll() 
will apply horizontal and vertical flipping of the input 102. if event.type == pygame.QUIT : 
image, and the R key will start off the auto-rotation of 163. terminate() 
the input image. 104. if event.type == pygame.KEYDOWN : 
We found that the best results were obtained 105. if event.key == pygame.K ESCAPE : 
when you could not imagine what the input image 106. terminate() 
was and it looked rather abstract. In fact, the most 107. if event.key == pygame.K_s : 
plain boring input images often produced better 108. SavePath = °° 
results than detail-packed ones. The quality of the 109. SaveScreen() 
auto-rotated images was Slightly degraded due to the 110. if event.key == pygame.K_RETURN : 
rotation process producing jagged edges on diagonal 111. SaveScreen() 
lines. One thing you will notice immediately is that a2. if event.key == pygame.K _r : 
if someone is in the input image, the results can look 113. autoRotate = not autoRotate 
quite ghoulish. 114 print( "Auto rotate =",autoRotate) 
115. if autoRotate: 
Taking it further 116. preRot = Q 
We used either a simple LEGO mount for the camera, at7 . if event.key == pygame.K_o : 
or nothing at all. However, we can’t help but think 118. SaveSource = not saveSource 
a pan-and-tilt mount moving slowly might produce 119. print("Save the source file =",saveSource) 
results that look good. There is scope for generating 120. if event.key == pygame.K_h : 
other degrees of symmetry using rotation instead of 121. flipH = not flipH 
flipping — see what you can produce. 122. print( "Flip horizontal now =",flipH) 
Unfortunately, we did not find a way for the image 123. if event.key == pygame.K_v : 
effects of the Raspberry Pi Camera Module to be 124. flipV = not flipV 
enabled when it is running into Pygame - maybe 125. print("Flip vertical now =",#flipV) 
some programming wizard could. Mind you, they 126. 
are all quite simple image-processing algorithms, 127. # Main program logic: 
so you could apply them by using software in the 128. if _name_ == ''_main_': 
pre-symmetry image manipulations. 129. main() 
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Tutorial 


Raspberry Pi 3 


C-STEMbian 
magpi.cc/ 
2p3JUNP 


Breadboard 
Jumper wires 
1x LED 


1 x 220Q resistor 
(Red-Red-Brown) 


TROUBLE- 
SHOOTING 
HELP 


Remember 

to use 
GPlOviewer 
for testing the 
pins before 
programming. 
If this fails, 
check the LED 
is plugged in 
properly and 
the wires for all 
components 
are in the 
correct spots. 


To better 
understand the 


layout of the board, 


click on the Board 
Layout tab 


Change the mode 
of a specific pin 
by selecting input, 
output, or PWM 


The name of each 
pin can be found 
in the centre of 
GPlOviewer 


USE A GUI TO 
CONTROL GPIO PINS 


Discover a simple way to interact with GPIO pins using C-STEM 


ne of the easiest ways to get started ona 
Raspberry Piis with C-STEM Studio on the 
C-STEMbian operating system. It removes 
many of the hassles associated with programming in 

C by using C/C++ interpreter Ch. Ch is superset of C 
with many high-level extensions. It can run C code 
without compilation. This article will demonstrate how 
to get started controlling GPIO pins on the Pi using 
GPlOviewer and WiringPi with a project in Ch and 
highlight some key features of the system. 

To make use of these programming tools, you 
should install the C-STEMbian operating system 
(magpi.cc/2p3JUNP) which contains C-STEM Studio. 
This free, open-source operating system contains 
all the necessary tools for robotics and physical 
computing. Additionally, it is a superset of Raspbian, 
so all the familiar features will still be there. If you 
already have Raspbian installed, the C-STEM modules 
can be installed separately on top. Step-by-step 
cuides will assist you in setting up and accessing the 
Raspberry Pi if needed. 


GPlOviewe 


6PiO-? Board Layout 


Value 


OesesgeooOooos 
S68 DOSGOSEoOoo 
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While this article will focus on ChIDE, GPIOviewer, 
and the WiringPi package, there are many additional 
features included in C-STEMbian: 


> C-STEM Studio (magpi.cc/2xEGEag), a platform for 
hands-on integrated learning of computing, science, 
technology, engineering, and mathematics (C-STEM). 


> Ch Mindstorms Controller for controlling multiple 
LEGO MINDSTORMS (EV3 or NXT) from the Raspberry 
Pi using a simple user interface 


> Linkbot Labs which, like the MINDSTORMS 
equivalent, gives a user interface for total control 
of one or more Linkbots. 


>» Ch Arduino for controlling and programming in Ch 
an Arduino Uno's pins from the Raspberry Pi. 


Make a circuit 

The program in this tutorial would be useless without 
a circuit to test it on. If you have one, use a breakout 
board to make the wiring process clearer. Otherwise, 
wire the pins directly from the Pi. Take a wire from 
the GPIO 4 pin and connect it to an empty row of the 
breadboard. Then, attach the positive lead of an LED 
to this row. From the negative lead of the LED, attach 
a 220 Q (Red-Red-Brown) resistor to ground. 

Before programming, we can use GPIOviewer, a 
helpful feature of the C-STEMbian operating system. 
To use it, navigate to the big ‘C’ on the top of the 
desktop window. 

Once open, navigate to ‘Ch Raspberry Pi’ and click 
Launch in the bottom right-hand corner. This will 
open up GPlOviewer, which allows total control of all 
GPIO pins of the Raspberry Pi. In this view, you can 
change pin modes between input, output, and PWM 
(with a slider). For this circuit, find GPIO pin 4 on 
GPIOviewer and set it to output. 

Ensure the circuit is set up and working properly by 
switching between high and low outputs. If the light 
turns on, you are ready to program. 
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Example blink code in C 

The classic way of programming this circuit on the 
Raspberry Pi would resemble the C code in blink.c, 
which includes the wiringPi library. This code also 
works in Ch interpretively without compilation. 


qanguage 


/* File: blink.c */ 
#include <wiringPi.h> 


int main() { 
wiringPiSetupGpio() ; 
pinMode(4, OUTPUT); 
while(1) { 
digitalWrite(4, HIGH); 


NAME: 
blink.c 


DOWNLOAD: 
magpi.cc/BlinkPi 


delay(50@) ; 
digitalWrite(4, LOW); 
delay(50@) ; 

} 

return @ ; 


The code uses GPIO pin numbering and sets pin 4 
to an output. Then, it enters a while loop that cycles 
the LED every half second between on and off. 
Notice the standard int main function that requires 
a‘return @statement. 


Equivalent Code in Ch 
However, to run the code just in Ch, the program can 
be simplified to the code in blink2.ch. 


qanguage 
>Ch 


/* File: blink2.ch */ 
#include <wiringPi.h> 


wiringPiSetupGpio() ; 
pinMode(4, OUTPUT); 
while(1) { 
digitalWrite(4, HIGH); 
delay(5@6) ; 
digitalWrite(4, LOW); 
delay(5@6) ; 


NAME: 
blink2.ch 


DOWNLOAD: 
magpi.cc/BlinkPi 


} 


Deb 82 KDBX se BAAR @ an | 
Ses ee eee 


¥ 
o 


1 f® File: blink2?.ch ®s 
2) finclude <miringPi.he 
# 


40 wiringPiSetupipiad j; 

S pintedat4, OUTPUT): 

a | 

Yr -ehile(1) { 

A digitalWrite{4, HIGH): 


18 digutalerite{d, Lite}: 
i delay (500); 
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USE A GUI TO CONTROL GPIO PINS 
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Above Set the 
circuit up as shown 
in the diagram, 
with a breakout 
board or with 
wiring directly 
from the Pi 


Notice that the int main function is gone. Just like 
Python and other scripting languages, there is no need 
to create any functions for a simple program. This is 
just one of the many benefits of using Ch. While this 
method of programming is most common for users 
coming from C programming, there is another way. 


Scripting in Ch 

Besides writing code resembling C, it is possible to 
write scripting code in Ch. The same program as 
before is rewritten in blink3.ch. 


#!/bin/ch 
/* File: blink3.ch*/ 


qanguage 
>Ch 


gpio -g mode 4 out 


TESLA) { siinicich 
Bien BME u Cee ay DOWNLOAD: 
delay(5@@) ; magpi.cc/BlinkPi 
gpio -g write 4 @ 
delay(50@) ; 

} 


Ch provides both methods as an option so that you 
can choose whichever is more comfortable for your 
style. To run the Ch code, it is easiest to use ChIDE. 

To launch it, click the magnifying glass icon next 

to the big ‘C’ you clicked to open C-STEM Studio. 
Alternatively, navigate to ‘Programming with Ch’ 
within C-STEM Studio’s menu. Type the code into the 
code editing pane. To run it, click the Run button at 
the top of the interface above the code. If all goes well, 
the LED should blink on and off indefinitely. 


Debugging 

Another useful feature of Ch is the ChIDE debugging 
feature. Like any popular IDE, the ChIDE provides easy 
to use debugging tools to step through Ch code. To 
step through the code, use the debug control panel at 
the top of the window. You can step into functions or 
through code with the Step and Next buttons, and you 


FOR HELP 
AND NEW 
IDEAS 


Open the 
‘Learn Physical 
Computing 


Loci a | Viana, Steck) WiteGan | [eesxpcerts 


debugr 


Above ChIDE provides easy-to-use debugging tools to step 


through Ch code 


raspberrypi.org/magpi 


are able to set break points by clicking in the grey line 
number column between the numbers and text. For 

example, set a break point by clicking in the grey area 
to the right of line 9. Then, click the Continue button. 


Every time you click this button, it will run the program 


until it hits another breakpoint. Since this is a while 
loop, it will hit this break point every time. 


with Raspberry 
Pi’ textbook 

in the Ch 
Raspberry 

Pi section of 
C-STEM Studio 
for more 
circuits and 
programs. 
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Tutorial STEP BY STEP 


MAKE A 


> 3D-printed star 
magpli.cc/ 
2i2tbkU 


> 3x RGBLEDs 


> 3x 150 resistors 


>6 x 100 resistors 
> 220 resistor 

> Push button 

> Wire 


> Breadboard 
(optional) 


EREREERERRREEE! 


[PRR RRRRREE 


Create the perfect tree topper with 
this 3D-printed, Pi- powered star, 
over which you have full control 


very year here at The MagPi, our Features 
Editor Rob Zwetsloot says he’s going to make a 
new Star for his Christmas tree that’s powered 
by a Raspberry Pi. This year he’s finally decided to put 
his money (or text) where his mouth is and make one. 
As Christmas is all about sharing, we thought 
he should also show you how to make one. After 
all, there’s nothing merrier than a Raspberry Pi 
Christmas. So get out your cinnamon-spiced soldering 
iron and put a Santa hat on your 3D printer and let’s 
create some festive joy. 


i, 


=—— 
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ROB ZWETSLOOT 


Tinkerer, sometime maker, other- 
times cosplayer, and all-the-time 
Features Editor of The MagPi. 

4 magpi.cc 


vad" 


vs 


Select a star 
The most important part of this project is the star. 
We’ve used one from Thingiverse (magpi.cc/2i2tbkU), 
which you can see in the pictures for this tutorial. 
However, you can use whatever star shape you want. 
All you need to do is make sure it’s hollow and you can 
easily access the inside of the star, but the electronics 
for the star will work the same in any case. 

You can look for different star shapes on 
Thingiverse (thingiverse.com), or even draft up 
your own in 3D modelling software like Blender. 


Get printing 
Not everyone has a 3D printer at home, however much 
we would all love Santa to bring us one. If you’re not 
lucky enough to have access to one at your workplace, 
your local makerspace might have one. 

If all these options are unavailable to you, then we 
highly recommend checking out 3dhubs.com. It’s 
a fantastic service that aggregates thousands of 3D 
printing services — all you need to do is set your location 
and upload your files and it will find a 3D printer. These 
might be a local business or a bigger company — either 
way, you can find out price estimates and what type of 
printer services each company provides. 

You don’t need to get very expensive material for 
the star, although we do recommend translucent 
plastic. Ours is orange, but you can likely find yellow 
if you prefer. 


Use this Fritzing diagram as a guide for wiring up the 
LEDs and button 
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>STEP-03 

Solder it up 

While waiting for your star parts to be delivered, now 
is a good time to build your circuit. It’s quite simple: 
each RGB LED colour pin is hooked up to its own GPIO 
pin, the ground pins go to ground (GND), and then 
the button gets its own pin. Check out Figure 1 for 

a wiring guide. 

The button and each colour pin of the RGB LEDs 
require a resistor for them to work, so don’t ignore 
them when testing or soldering up your circuit! 

Figure out where you want to put the Pi relative 
to your tree and cut the wires for the distance 
accordingly. Alternatively, try hiding a Pi Zero 
in the star! 


>STEP-04 
Add the code 
We have some example code you can try out, called 
star_lights.py. Make sure Raspbian is installed on the 
Pi you plan to use and write it up/download it to the 
home folder. Run the code to test out the circuit and 
make sure everything works — it should start with all 
the LEDs lighting up white, then each button press 
will change it: blinking, then pulsing, then all on 
with different colours, then blinking or pulsing with 
different colours. 

In the Terminal, use sudo nano /etc/profile and 
add the following line to the bottom so that the code 
runs at startup: 


sudo python star_lights.py 


>STEP-05 

Construct the star 

Once the star has arrived, use some sticky tape 
to carefully stick the LEDs to the star. We stuck 
ours to the rear half of our two-part star and then 
glued the bits together. Give it another test to see 
if you’re happy with it. Modify the code as you see 
fit (see the GPIO Zero RGBLED doc for reference: 
magpi.cc/2i3MTgq) and turn off ‘boot to desktop’ 
in the Pi configuration to save some power. 


>STEP-06 
The tree-topping ceremony 
Now is the big moment. Decorate the rest of your tree, 
eet your favourite Christmas jumper out, and put the 
kettle on. If you have a tall tree, get a ladder out - 
safety first, after all - and place your star over the top 
part of the tree. 

There. Christmas has begun. We recommend 
pairing your ceremony with a nice cup of tea 
(which is why we told you to put the kettle on) 
and a mince pie. From all of us at The MagPi, we 
wish you a Merry Christmas, Happy Holidays, and 
a Happy New Year! 
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MAKE A MAGIC CHRISTMAS STAR 


star_lights.py 


from gpiozero import RGBLED, Button 
from time import sleep 


led1 = RGBLED(14,15,18) 
led2 = RGBLED(23, 24,25) 
led3 = RGBLED(8,7,12) 


button = Button(21) 


mode1 = (1, 0, 0) # Red 
mode2 = (@, 1, @) # Green 


while True: 
led1.on() 
led2.o0n() 
led3.on() 


button.wait_for_press() 
button.wait_ for release() 


led1.blink() 
Sleep(@.4) 
led2.blink() 
sleep(@.4) 
led3.blink() 


button.wait_for_press() 
button.wait_for_ release() 


led1.pulse() 
sleep(@.4) 
led2.pulse() 
Sleep(0.4) 
led3.pulse() 


button.wait_for_press() 
button.wait_for release() 


led1.on() 
led2.color(mode1) 
led3.color(mode2) 


button.wait_for_press() 
button.wait_ for release() 


>PYTHON 


DOWNLOAD: 
magpi.cc/ 
magpistar 


ledi.blink(on_color=(mode1), off_color=(mode2) ) 


sleep(@.4) 


led2.blink(on_color=(mode2), off _color=(mode1) ) 


sleep(@.4) 


led3.blink(on_color=(mode1), off_color=(mode2) ) 


button.wait_for_press() 
button.wait_for_ release() 


led1.pulse(on_color=(mode1), off_color=(mode2) ) 


Sleep(@.4) 


led2.pulse(on_color=(mode2), off _color=(mode1) ) 


sleep(@.4) 


led3.pulse(on_color=(mode1), off _color=(mode2) ) 
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Tutorial 


DIY INDOOR 
AIR-QUALITY 
MONITOR 


Build your own indoor air-quality monitor using the Raspberry Pi Zero 


n this tutorial, you will learn to build yourown Connect the sensor 


indoor air-quality monitor/data logger. We The CCS811 sensor comes with an [°C interface and 
| will build it using the Raspberry Pi Zero and requires a 3.3 V power source. The clock and data pins 
epee the CCS811 volatile organic compound sensor. of the sensor needs to be connected to the pins GPIO 3 


Zero 
The collected data would be used to provide avisual and GPIO 2 respectively (shown in Figure 1). 


indication of the air quality (using an RGB LED strip) 


Pimoroni Blinkt! 


LED strip 

. and the information collected would be saved toa Test the sensor 
seoeledtiidllle Google Sheets spreadsheet. The visual aid serves to The first step is to enable the [°C interface and verify 
Mini Kit educate people about their immediate surroundings that the sensor is interfaced correctly and check 
Sparkfun CCS811 while the data saved to a spreadsheet helps whether the Raspberry Pi is able to detect the sensor 
sensor understand the air-quality trends in a room. on the [°C interface. 


Stackable 2x20 
female headers 


The CCS811 VOC sensor is 
interfaced to the Raspberry Pi 
Zero via the I?7C interface 


4 x Male-to-male 
jumper cables 


3D-printed 
enclosure 
(source files 
available with 
this tutorial) 


The data collected from the 
sensor is logged to a Google 
Sheets spreadsheet using 
IFTTT (if-this-then-that) 


VOC_Data a 


File Cott Whew Inset Plonmeal [lade Tools Add-ons Hele 


S- = & 100% $5 % 0 OO 10- uri 


Auguet 6, 2017 at 09445Fh 


a Hi 
rea | Ohetober 1, 2017 at O7-734M nn 
1290 | October 1, 2017 al 03:38AM N35 
11 | Oclober 1, 2077 al 03:534M 455 
(282 | October 1, 2017 af 04:08AM 438 
1233 October 1, 2017 af 04-234¢ 443 
i204 | October 1, 2017 al 04:38AM i274 
1m | Gectober 1, 2017 at 64:654é A26 
1288 October 1, 2017 a1 05:08AM 424 : ' ja The Pimoroni Blinkt! is used 
izay October 1. 2017 af 05:23AM 424 : | es to provide a visual indication 
1988 October 1, 2017 at 05:30AM 430 : | \ITengy st of the air quality in the 
1288 | October 1, 2017 at 05:59AM 465 ‘ “Te tor immediate surroundings 
race | October 1, 2017 at 06.06AM 435 


1 | October 1, 201T af 06F30M Fis fa 
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The PC interface can be enabled from the Raspberry 
Pi’s desktop. Go to Menu> Preferences > Raspberry Pi 
Configuration. Under the Interfaces tab, enable the 
‘12C’ interface. 

Now, open the Terminal and enter: 


sudo i2cdetect -y 1 


The above command should list all the devices 
connected to the Raspberry Pi’s PC interface. As 
shown in Figure 2, the CCS811 sensor’s address is 
ox5A. According to the sensor’s data sheet, the sensor 
could be configured to the address ox5A or Ox5B. 

The next step is setting the clock rate of the ?C 
interface. We need to adjust the [?C interface clock 
speed to meet the sensor’s clock rate specification. 
Edit /boot/config.txt from the Terminal: 


sudo nano /boot/config.txt 
Add the following line to the end of the file: 
dtparam=i2c_ baudrate=8000 


Save the changes to the file (CTRL+X) and reboot 
your Raspberry Pi. 


Above The observed volatile organic compound trend overa 
24-hour period. This information can be useful in identifying 
ventilation needs for a room 
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DIY INDOOR AIR-QUALITY MONITOR 


The CCS811 sensor 
is connected to 3V3 and GND, 
and its clock and data pins to 
GPIO 3 and 2 respectively 
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Install the prerequisite libraries 
In order to read data from the sensor, we need to 
install some dependent libraries: 


pip install python-periphery requests 
configparser 
sudo apt-get install python-blinkt 


We installed the python-periphery library to access 
the [?C interface and the Python requests library to 
upload the sensor data to a Google Sheets spreadsheet. 
We installed the blinkt library by Pimoroni to control 


the RGB LED strip. If you are using a different RGB LED, 


install the prerequisite library for the same (if any). 

Note: At the time of building this gadget, there were 
no libraries readily available to read data from the 
CCS811 sensor; therefore, we wrote our own library. 
Adafruit Industries has since published its own library 
(pypkg.com/pypi/adafruit-ccs811). Choose a library 
that meets your needs. 


Tutorial 


INSTALLATION 


Install the 
gadget in your 
living room to 
understand 
Whether the air 


quality in your 
home needs 
improvement. 


Figure 2 

Listing all devices 
connected to the 
Pi's I?C interface 


gp pi@raspberrypi: ~ 
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Tutorial WALKTHROUGH 


[1 = import blinkt 
from time import sleep 
Your Key Is: while True: 
Haren blinkt.set_al1(255, @ , @) 
blinkt.show() 
peepee Read data from the sensor sleep(1) 
and storeitinthe Before we put everything together, we need to test blinkt.set_all(@, 255, @Q) 
key.inifile — every component of our gadget. Let’s get started with blinkt.show() 
testing the sensor. In order to verify that the sensor sleep(1) 


VISUAL AID 


Use a Sharpie 
or permanent 
marker to 
demonstrate 
the effect of 
volatile organic 
compounds. 
Do not use the 
VOC sensor 

to measure 
carbon 
dioxide levels. 


Figure 4 The 
enclosure can be 
3D-printed using 
the STL files in the 
project repository 


operates as expected, we need to perform a simple 
transaction using the I?C interface. According to 
the data sheet, it is possible to read the value at the 
register, 0x20, and retrieve the hardware ID of the 
sensor. In this case, it is 129 (hex: 0x81). 

The code for this gadget can be downloaded from 
the GitHub repository (magpi.cc/2zrzuXP). From 
the Terminal, switch to the directory containing the 
code. Launch the Python interpreter and execute 
the following: 


>>> import ccs811 

>>> my_ccs811 = ccs811.CCS811(device _ 
address=@x5A) 

>>> print(my_ccs811.read_byte(@x2®@) ) 

129 


Now that we have the verified the sensor function, 
let’s test the RGB LED strip. 


Testing the RGB LED strip 
We used the Pimoroni Blinkt! LED strip 
(magpi.cc/2yg5Mng) for this tutorial. Pimoroni 
provides the library required to control the RGB 
LED strip and hence it is very easy to integrate into 
the project. 

The library installation is a one-stop process 
(shown in the prerequisite installation step). 
Let’s write a quick Python script to test the library: 
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The LED strip should alternate between red and 
ereen colours with a one-second interval. 


Setting up your IFTTT account 

We will be using IFTTT (if this, then that) to save the 
sensor data to a spreadsheet. If you are not familiar 
with IFTTIT, we recommend reading this tutorial from 
The MagPi (magpi.cc/2yicro8) — note that the Maker 
Channel is now called the Webhooks service. 

To save the data to a spreadsheet, we create an IFTTT 
applet where a webhook containing the sensor data is 
used as a trigger to add a row to the spreadsheet. 

Record your webhook key from the webhook 
documentation page: Your Profile > Services > 
Webhooks > Documentation (Figure 3). 

Save your key ina file called key.ini (or any file 
name of your choice) in the following format: 


[CREDENTIALS] 
key = YOUR_KEY 


Replace the text YOUR_KEY with your IFTTT 
key. Now, let’s test if we are able to add a row 
to a spreadsheet. 


config = configparser.ConfigParser() 
config.read('/home/pi/key.ini' ) 
key = config.get('CREDENTIALS', 'key') 
payload = {'valuei1': 1, 'value2': 2} 
print(URL. format (key=key) ) 
try: 
response = requests.post(URL. 
format (key=key), json=payload) 
except requests.exceptions. 
ConnectionError as error: 
print(str(error) ) 
if response.status_ code == 200: 
print("Success" ) 


If the sensor data was successfully posted, you 
should be able to verify that a row has been added to 
the spreadsheet. 


Soldering/assembly 

Now that we have verified the components, let’s 
solder the sensor onto a prototyping board. We 
recommend using the Adafruit Perma Proto Bonnet 
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Mini Kit (magpi.cc/2yg7oxk), since it comes with the 
same profile as the Raspberry Pi Zero. Instead of using 
the headers that come with the kit, we recommend 
using the stackable headers (magpi.cc/2yidoag). This 
would enable stacking the Pimoroni Blinkt! LED strip 
on top of the Proto Bonnet Mini Kit. 


Enclosure 

In order to produce an orb-like effect, we used an 
enclosure that diffuses light. We designed an enclosure 
that could be built using a 3D printer (Figure 4). We 
recommend using a white filament, as it best diffuses 
the light. The enclosure consists of a top portion that 
diffuses the light and a bottom portion that holds 

the Raspberry Pi Zero. The enclosure design files are 
available in the project repository (magpi.cc/2zrzuXP). 


Putting everything together 

Once you have assembled the Raspberry Pi Zero, 
CCS811 sensor, and LED strip into the enclosure, it is 
time to test the gadget. The code consists of a CCS811 
class that handles all interactions with the sensor, 1.e. 
reads/writes data to the sensor. 

When the script is run, the sensor is reset and 
initialised. Upon initialisation, we poll the status 
register to determine if new data samples are available. 
According to the data sheet, the DATA_READY flag 
indicates whether a new sample is available. 

When a new sample from the sensor is available, the 
program fetches the equivalent carbon dioxide levels 
and the volatile organic compound levels (VOC). We 
use the VOC levels to set the colour of the RGB strip. 
For example, if the VOC levels are below 16 ppb, we set 
the colour to green; if they are greater than 60 ppb, the 
RGB strip is set to red. The FadeInOut method is used 
to produce a light effect by adjusting the brightness 
levels of the LED strip. Every 15 minutes, a data point 
is uploaded to the Google spreadsheet using the 
post_data method. If the ERROR flag of the STATUS 
register is set, the program automatically resets the 
sensor and re-initialises the communications. 

Run the Python script and the gadget should start 
elowing green. Open a permanent marker or any pen 
that has an odour and introduce it into the enclosure. 
You will notice that the enclosure changes colour from 
ereen to red. 


NOTE: The CCS811 sensor requires a 48-hour burn-in 
and at least 20 minutes after power-up to provide 
stable readings. 


VOC trends from spreadsheet 

Let the gadget run for at least 24 hours and collect 
data in 15-minute intervals. It would be interesting 
to look at the trends and find out if your room needs 
modifications to its ventilation. 
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The sensor started 
glowing red whena 
Sharpie was brought 
close to the enclosure 


>PYTHON 


NAME: 


ccs811.py 


DOWNLOAD: 


magpi.cc/ 2zrzuXP 


BEN (BENSTR) STRAHAN 


Benstr leads Developer Relations at 
hologram.io. His job is to make cool 
~ projects, connecting ‘things’ to the 
world with cellular. 
hackster.io/benstr / @_benstr 


CONNECT YOUR 
WITH CELLULAR 


Youll 
Need 


> Hologram 
Developer SIM 
hologram.io/ 
devplan 


Connect your Pi to the 
mobile network and use 
a phone to chat to it 


> Hologram Nova Ask the Pisome 
hologram.io/ sample questions 
nova j via SMS messages 


> Hologram 
Python SDK 
magpli.cc/ 
2zfB6Co 


You can easily add extra set 
responses to the code or 
modify it to use local Al 
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Going places without WiFi? Ben Strahan shows how to use mobile 
networks and send SMS messages to your Pi 


ver wonder what your Raspberry Pi was 

thinking? This tutorial shows how you can ask 

your Pi questions no matter where it is in the 
world. Learn how to send questions through SMS to 
your Raspberry Pi and get witty answers back. 

You’ve probably connected your Pi to the internet 
through Ethernet or WiFi, but have you ever 
considered using cellular? After all, your WiFi only 
covers a small portion of the planet. 

This tutorial explores using cellular with the 
Raspberry Pi family. Hologram.io recently released 
the Nova, a USB modem built for single-board 
computers like the Pi. The Nova, Hologram’s Python 
SDK, and Hologram’s global cellular network 
make connecting your Pi to the mobile phone 
network simple. 

This tutorial requires the Hologram Nova which 
includes a free SIM. Learn more at hologram.io/nova. 


Hologram SIM configuration 

Upon receiving your Nova and SIM, you need to 
activate the SIM to make the worldwide network 
available. From the Hologram Dashboard 
(magpi.cc/2ijHyFn), click the Activate SIM button in 
the top right-hand corner. After activation you’ ll be 
directed to the device list page. You should see your 
new device in the list; it may not be clickable while it 
provisions onto the network. 

Once the device is available, click it to be taken to 
the device details page. On the left you’1l notice the 
device sub-navigation. For this tutorial we’ll need to 
configure a device phone number and Cloud Services 
credentials. Select Configuration in the side-nav and 
walk through Configure Phone Number and Cloud 
Services Router sections. Make sure to save the phone 
number and device key for later use. 
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CONNECT YOUR RASPBERRY PI WITH CELLULAR | Tutorial 


Activate your SIM 


is BUUEEe 


Hologram provides instant activation and SIM management 


through a self-managed dashboard 


Local Pi configuration 
Next, we’re going to install all the dependencies 
this tutorial requires. Again, Hologram makes 
this very simple with a single-line command. It’s 
recommended you be connected to the internet 
through WiFi or Ethernet since these dependencies 
will use a lot of data. 

On the Pi, open a Terminal window and run the 
following script: 


curl -L hologram.io/python-install | bash 


For this tutorial we’ll need one more dependency: 


sudo apt-get install python-psutil 

You can now connect the Nova to your Pi. We’1l 
run the following code to verify everything is 
installed correctly. 


sudo hologram send —cloud "Hello World!" 


Along with the Python SDK, Hologram’s script 


installed a neat little command-line interface (CLI). 


Learn more about what the CLI can do by executing 
the following commands: 


hologram —help 
hologram modem —help 


Head over to the Hologram Dashboard 
(magpi.cc/2ijHyFn) to see your ‘Hello Nova 
command above. 


) 


For the SMS data to be routed correctly, 
you need to add the unique device key 
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Nova is a pretty 
versatile modem 
thanks to its 
open design and 
USB interface 


Run SMS conversation script qangquage 
Let’s get the code so we can start talking with >PYTHON 
our Pi over SMS. From the Pi Terminal, clone the 

following repository. NAME: 


askPiSMS.py 


git clone https://github.com/benstr/TUT- DOWNLOAD: 


ask-pi-sms.git magpi.cc/2ztwE3X 


Remember the device key you generated in the first 
step? Paste the device key on line 6 of the script. 


cd TUT-ask-pi-sms 
sudo nano askPiSMS. py 


Save the file. You’re now ready to run the script 
and text your new robot friend, fingers crossed! 


sudo python askPiSMS.py 


From your phone, send the following questions 
to the phone number you received earlier. 


> What is your name? 
> How old are you? 

> Do you have a body? 
> How smart are you? 


By default, SMS is slow on all networks. Also, for 
simplicity, the code is not very fast. For both reasons, 
it might take 30-60 seconds to receive a response. 

Congrats, you have a new robot friend you can chat 
with! Modify the code to support more questions or 
add local AI to have a truly intelligent friend. 
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Lakka lets you relive the games of the past by enabling your 
Raspberry Pi to emulate a host of retro computers and consoles 
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NEEDA 
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Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


SD CARD 


MAINTENANCE 


Corruption 

SD cards, like any form of computer storage, can 
become corrupted. This means certain (or all) sections 
of the memory become unreadable by a computer 

like the Raspberry Pi. In this case, your files will 

be generally irretrievable and the SD card will 

become useless. 


60 


End of life 

Solid-state storage solutions like SD cards, USB flash 
drives and SSDs have a finite lifespan which is dictated 
by how much you use them. Don’t worry, though: you’re 
very unlikely to ever use your Pi’s SD card enough to 
break it that way. 


Physical problems 

SD cards, especially the microSD cards used in 

most Raspberry Pis, are small and flimsy. It’s not 
uncommon to lose them when transporting them 
somewhere and while they’ re not easy to snap, they 
are definitely breakable. 


Properly shut down 

Corruption usually occurs when data is being written 
and suddenly the storage is removed or there’s a loss 
of power. You should never remove the SD card while 
the Pi is running anyway, but you might remove the 
power to turn it off. Always make sure to shut it down 
via the Shutdown option in the desktop menu, or with 
the Terminal command sudo shutdown -h now. 


Boot to RAM 
Not every Pi is used in the same way, and sometimes 
you won’t be able to always turn it off properly. In the 
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case where you need to regularly pull the plug on it, 
you can use piCore (magpi.cc/2ueA7UI) as your distro. 
This loads into RAM at boot, so won’t be writing when 
you pull the plug. If you want to stick with Raspbian, 
try making it read-only: magpi.cc/211LkQ5. 


Keep it safe 

SD cards usually come with protective cases, which 
can aid in transporting them if you need to carry them 
around on their own. Otherwise, we find that keeping 
the card in a Pi we’re transporting (preferably in its 
own case) means it stays relatively safe and is hard 

to lose. 


Documentation and instructions 

The quickest and most low-tech way to back up your 
important files is simply to transfer them to a USB 
stick. You can also save files to another computer 
over the network, or simply plug the SD card into 

a computer that can read ext file systems and 

copy them. 


Cloud backup 

While services such as Dropbox and Google Drive 
don’t support Raspbian very well, you can set up 
Dropbox to manually sync files on the Raspberry Pi. 
With that in place, you can then automate the timing 
of this manual sync and have it behave almost like 
standard Dropbox: magpi.cc/2c9NnPC. 


Card clone 

Creating a complete 
copy of your SD card 
means you also get to 
Save your software and 
settings along with your 
important files. You can 
create a copy using the 
SD Card Copier tool 
built into Raspbian, 
or simply plug the 
SD card into another 
PC and make a copy 
from there. 
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FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHAT SOC ARE YOU USING? 


All models of Raspberry Pi use Broadcom SoCs containing 


a VideoCore IV GPU, but with various ARM CPU cores. 

The original Raspberry Pi used a Broadcom BCM2835. 
This contains a single-core ARM1176JZFS with floating 
point, running at ZOOMHz, and a VideoCore IV GPU. The 
GPU is capable of Blu-ray-quality playback, using H.264 
at 40MBits/s. It has a fast 3D core, accessed using the 
supplied OpenGL ES 2.0 and OpenvVG libraries. 

The Pi 2 Model B originally used the Broadcom 
BCM2836. This contains a quad-core ARM Cortex-A7 
processor with floating point and NEON, running at 
QOOMHz, and the same VideoCore IV GPU that is in the 
earlier models of Raspberry Pi. 

The Pi 3 Model B uses the Broadcom BCM2837 
containing a quad-core ARM Cortex-A53 running at 


1.2GHz. Its GPU capabilities are equivalent to the Pi 2. 
Some versions of the Pi 2 now use the same SoC as 
the Pi 3, but downclocked to match the speed of the 
Original Pi 2 SoC. In the future, every Pi 2 will use this 
newer SoC, 


WHAT IS AN SOC? 

A system ona chip (SoC) is a method of placing all 
necessary electronics for running a computer on 

a single chip. Instead of having separate chips for 
the CPU, GPU, USB controller, RAM, northbridge, 
southbridge, and so on, everything is compressed 
down into one tidy package. 


WHY DID YOU SELECT THE SOC? 
Cost and performance. 
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Feature 


CREATE YOUR OWN 


ADVENTURE 


Using Twine 2, 
anyone can easily 
create a choice- 
based interactive 
fiction game and 
publish it online 


K.G. 


ORPHANIDES 
K.G. is a tech 
journalist whose 
experiments in 
interactive fiction 
have ranged from 
Multi-User Shared 


vege - twineJs 
Hallucinations to pee 
gamebooks and ‘ 
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a legacy almost as long 
as modern computing. 
Created on a PDP-10 mainframe 
in 1975, Will Crowther’s Colossal 
Cave Adventure is generally 
recognised as the first text 
adventure, allowing players to 
enter simple commands like GO 
NORTH and TAKE LAMP. 
It inspired the entire 
text adventure genre, with 
Infocom’s Zork (1979) and 
Adventure International’s 
Adventureland (1978) 


C ext-based games have 
| 


text adventures. 


In the UK, Games 


becoming some of the first 
commercial parser-based 


Meanwhile, a different 
kind of interactive fiction 
was coming to bookshops. 


a GAMEBOOK « i . 
Ly Cwine 


Workshop co-founders Steve 
Jackson and Ian Livingstone added 
tabletop role-playing elements to 
their Fighting Fantasy gamebooks, 
the first of which, The Warlock of 
Firetop Mountain, was published 

by Puffin Books in 1982. With 
shorter passages, more choices, 

a character sheet, and a dice- 
based combat system, Fighting 
Fantasy would define adventure 
gamebooks for generations of 
British kids. 

It’s these that we’ll be taking 
inspiration from with this tutorial, 
showing you how to implement 
not just a branching, choice-based 
plot, but also exciting action, 
lucky rolls of the dice, anda 
character who can be affected - 
and even killed — by the challenges 
they face. 
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Fighting Fantasy gamebooks set 
the standard for fantasy adventures 
with branching paths to explore 
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INTRODUCING TWINE 


In this tutorial, we’re going 

to use Twine 2 and its default 
Harlowe programming language 
to create an interactive fantasy 
fiction adventure. Twine is 


specifically built to be easy to use. 


You can create a simple, choice- 
based story without writing a 
single line of code, but it also 
gives you a Surprisingly flexible 
programming environment that 
you can use to implement logic, 
stats, event flags, and random 
dice rolls. 


INSTALLING AND 
RUNNING TWINE 2 


Stand-alone Twine desktop 
clients are available for a 
number of systems, but not 
ARM-based computers like the 
Raspberry Pi - for now, at any 
rate. However, there’s a ready- 
made local web version of the 
engine called TwineJS maintained 
by original creator Chris Klimas, 
and all you need to run it is 

a web browser. 
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THE ROAD TO ADVENTURE 


To go with this tutorial and illustrate the 
techniques used in it, we’ve created a demo 
game, The Road to Adventure™, which you can 
find online at : 

To import it into your own copy of Twine, 
download the HTML source file linked on the 
main game page, open Twine, and select ‘Import 
from file’ on the right-hand bar of the Twine 
home screen. 


and download the latest 
version of Twine — the plain 
zip file, with no operating 
system mentioned. At the 
time of writing, that’s 
twine_2.1.3.zip. 


3. Open index.html 
to start Twine. 


It runs in a browser, but all 
files are stored locally. Your 
game can be edited and built fully 
offline, but unlike some other 
implementations of the client, 
you’ll have to manually export bid 
your works in progress (which ‘ 
is actually best practice for all 
iterations of Twine). 

While Twine 2 should work 
perfectly in any JavaScript-enabled 
browser, we’ re going to run it in 
Chromium and we suggest that 
you do the same while following 
this tutorial. 


feature 


RESOURCES 


Harlowe manual 


Publish for free on Itch.io 


UD) fei hrormea, kg Downbordstwing_ 2. djindechtmitlitorner/abeber 10-24ca4e-ad 1-0 TTR GeO 


he first time you run 
| Twine 2, a few tutorial 
paragraphs point you at 
some online documentation and 
tell you how to save your work. 
After that, you’ll be taken to 
Twine’s main index screen, where 
we can begin writing our game. 


GETTING STARTED 


Click the green Story button 

in the bar on the right and name 
your tale when prompted. A graph- 
paper-like screen will appear with 
a Single box in the middle, marked 
Untitled passage. Double-click on 
the box to open the editing screen 

Passage boxes are where 
you'll spend most of your time 
in Twine. Click into the title 
bar — currently marked Untitled 
Passage — and give it aname. 

Only you will be able to see this 

title, so you can call it whatever 
you like, as it won’t be visible to 
the player. 

Below is the main box where 
you'll enter text for your players to 
read. As it suggests, double-click 
on the sample text currently in the 


passage and Start typing to begin 
composing your own story. 
There’s also a Tags box, invisible 
to the player, which you can use 
to mark passages for your own 
reference or to apply repeated text 
or code to your game, for example 
in header and footer passages. 
While this is beyond the scope of 
our tutorial, you can learn more 
about it in Twine’s documentation. 
Everything you type ina 
passage is automatically saved 
to your browser’s cache in real 
time. This means that, even if your 
computer crashes, nothing will be 
lost. However, it’s very important 
to back up your game (see ‘Save 
often’) before making any major 
changes to its text or code. 


YOUR FIRST LINK 

In our first gameplay passage - 
called Spitz Adventurers’ Guild 
Barracks in our demo game — 
we’ve described the barracks 

of an adventurer’s guild and 

set up the plot for our story. 
Our character’s motivation is 
simple: hunt monsters for fame 
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Each box represents a passage of text, 
with arrows indicating direct links 
between one page and another. 
Double-click on a passage box to edit it 


Opened by clicking on your story's 
name, the story menu gives you tools 
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to edit the way your story is displayed, 
rename it, and publish it 
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Mouse-over any passage and icons 
allow you to delete, edit or test it, or 
set it as the game's starting point 
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Click the Passage button to create a 
new text passage. New passages are 
also automatically created when you 
write linking code in any passage 


@ The Road to Adventure « 
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feature 


and fortune. But now we’ve got 
to get them to the next stage of 
their adventure. 

To do this, we’re going to create 
a simple link. When using Twine 
and Harlowe, any string of text 
you put between two sets of square 
brackets [[like this]], Twine 
will automatically create a passage 
with the same name as your link. 
With that done, click the X in the 
top right to close. 


MAKE ROOM, 
MAKE ROOM 
Back on the map screen, you’ll 
see that a new passage has been 
created. If we rename it, the link 
pointing to it will be automatically 
updated to reflect this. However, 
you can also create a link that 
points to a passage with a name 
that’s different to the link text. 

In our code example (see 
‘A link to the future’) we 
have used different linking 
methods, one of which involves 
the same bracketed format we 
used earlier, but with an arrow 
pointing at the new passage name 
[[so this->leads to this]]. 
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A third method involves our first 
introduction to Harlowe’s built- 
in macros. The (link: ) macro 
makes a link that will appear on 
our current page. When the player 
clicks on it, the game will carry 
out any commands within a pair 
of brackets that follow it. 

In this case, that’s just a 
(goto: ) macro, which will do 
the same job as a normal link. 
However, it doesn’t automatically 
create your destination passage 
and won’t display a link arrow on 
the map view. 

That means that if we create a 
passage with this bit of code in it 
- (link: “Go north” )[ (goto: 
“Town gate”) ] — we then have 
to manually create a new passage 
called Town gate, because one will 
not automatically be created when 
using this method. 

We’ll generally only use this kind 
of link when we need to call other 
functions when it’s clicked. Later, 
we’ll be using (link: ) to tell 
Twine to set variables, check for 
previously set states, and carry out 
random dice rolls as we move from 
one passage to the next. 
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# Stories 


A main index page - which you can 
return to using the Home icon on your 
story map - lists all your creations 
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Ow we’ve got to grips with 
linking passages - the 
most fundamental aspect 
of Twine - we can move on to using 
more of Harlowe’s macros and 
stringing them together to add 
gameplay to our interactive story. 


BRACKETS ARE 
REALLY IMPORTANT 

In any programming language, 
structuring your code correctly 
is important when it comes to 
making it human-readable and 
ensuring that you’ve got all your 
punctuation in the right places. 
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Twine helpfully has built-in 
syntax highlighting to make it easy 
to see which bits of your code go 
with each other, but you’ll also 
want to make sure you don’t lose 
track of how many square brackets 
you’re using. 

When using conditional macros 
such as (if: ), (else-if:), and 
(else: ), remember that anything 
that happens in response to those 
conditions must be placed between 
a pair of [square brackets]. 

You can nest multiple macros 
in these, so although it’s 
not essential for the correct 


functioning of your program, it a 
good idea to use tabs and carriage 
returns to keep large blocks of 
code tidy — see our examples 

for a demonstration. 

Twine automatically saves every 
change you make instantly, and 
you can’t rely on a CTRL+Z undo 
function if you accidentally delete a 
line you wanted. 

Save regular copies of your work 
and when working on a complex bit 
of code, it’s a good idea to cut and 
paste it to a new passage to make 
it easier to revert to the original 
version if required. 


VARIABLES (SET:) 
UP THE STORY 


In our character creation code 
(see ‘Set your stats’), we’ve used 
macros to define our hero’s name, 
hit points, attack, luck, and a few 
other stats. We start by asking the 
player to name their hero, which 
we’ll use the (set: ) macro to save 
as a variable called $name. The 
(prompt: ) macro creates a text 
entry box. The second bit of text in 
quotes, "Avatar", is the suggested 
text for the entry box, in case the 
player doesn’t want to come up 
with their own name. 

Everything else is set when the 
player clicks the ‘It’s time to go’ 
link. The (link: ) macro defines 
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the text the player sees. Then 

we use (set: ) macros to set our 
variables. Here, $luck is set to 

the number 7. If you’re setting a 
variable to a text string, such as 
our $battlecry variable, you have 
to enclose it in inverted commas. 

The final (goto: ) line tells 
the program where the link will 
go after everything has been set. 
From now on, any time we put 
$name or $luck into the text of 
a passage, the game will display 
those variables. 

So if we create a passage 
introducing a tavern keeper, she 
can say "What ho, $name! Come 
over and have a drink!", and 
the player character’s name will 
appear in the sentence. 


ROLL THE BONES 


Rolling dice — or rather, generating 
random numbers — is a key factor 
of games and is also really simple 
to do using Harlowe. Just use the 
(random: ) macro with the bottom 
and top of the random number 
range you want. To roll a six-sided 
die, you put (random: 1,6), and 
Twine will spit out the result. To 
make it part of a game, we’ll use it 
to roll against a stat. 

The ‘Roll for luck’ box code 
demonstrates one way of doing this. 
Our (link: ) shows the player a 
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link saying ‘Swim for it — roll for 
luck’. Telling the player when 
they’re rolling dice helps to create 
the feel of a gamebook. 

Here, we (set: ) a variable 
called $roll1 to the result of a 
(random: ) number between 1 and 
10, to simulate a ten-sided die. 

(if: ) the character’s $luck 
Stat, which we (set: ) during 
character creation, is greater 
than or equal to (>=) the random 
number we stored in the $roll 
variable just now, our hero swims 
to safety and, when they select 
Continue, washes up in an area 
called ‘Beneath the docks’ thanks 
to a (goto: ) command. 

As this is a simple either/or 
Situation, we can use the basic 
(else: ) command to handle 
what happens otherwise. So, 
if the player’s luck is less than 
the random number, they’re 
sent to a passage called ‘You 
have drowned’ using a (link: ) 

[ (goto: ) ] macro command. 
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Integrated debug tools help 
you see where a piece of 
code is failing 
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FIGHT ME 


It’s not aclassic fantasy adventure 
without a bit of monster-bashing, 
so our final section of sample 

code shows you how to set up a 
combat routine. 

The nice thing about this bit 
of code is that you can reuse it 
anywhere you like with only a few 
tweaks to change the name of the 
monster, set by the $monster 
variable; its hit points, set in 
$mob_hp; and its base attack, 
defined by $monster_atk. 

These are all defined using the 
(set: ) command with a link that 
goes from a previous passage to the 
combat sequence itself. They’ re 
locked in when the player selects 
the ‘Fight the skeleton’ link. 

The combat sequence is designed 
as a loop that responds to the 
player’s decisions. Each loop 
represents one round of combat. 

& If neither the player character 
‘ nor the monster are reduced to 
zero hit points during combat, the 
player will be given the option of 
either escaping or continuing with 
eg another round of combat. 
Ww f= At the beginning of each round, 
| the game rolls a ten-sided die 
| for both player and monster. The 
re results are added to their base 
: attack stats. Whoever has the 
| highest score knocks two hit points 
a off the other. If both scores are 
> equal, neither hits. 
| Note that we use greater than (>) 
or less than (<) signs for most of 
i these comparisons, but if we want 
to see if their attacks equal each 
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THE SETUP 


THE FIGHT 


THE PAYOFF 
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other, we have to use the word is, 
asin (else-if: $mob_atk is 
$hero_atk)[outcome]. 

The whole routine is very simple, 
but it does the job. As you become 
more familiar with Harlowe, you 
could add extra features, such as 
modifying the $atk variable to 
increase the amount of damage 
the player does if they get a shiny 
new axe, or requiring a luck 
roll to successfully escape from 
the monster. 

If the player dies, we offer them 
the opportunity of restarting the 
game from the beginning. By 
default, Twine has a back button, 
so they’1l probably just flip back to 
before the fight started - as most 
people do with physical gamebooks 
— but the (reload: ) link is great 
for people who want to play an 
honest game or if you use Twine’s 
Stylesheet editor to remove the 
back button. 

If the player wins the fight, then 
we take them to a victory screen 
where we can award them loot, 
move them further along a fixed 
story path, or - if we want them 
to be able to return to the same 
location in the future - (set: ) 

a variable to mark the enemy as 
defeated so that it doesn’t appear 
a second time. 


DEBUG ZAPPER 


Twine has a built-in debugging tool 
that’ll help you spot where and 
why your code is going wrong. To 
run the game from the beginning 
in the debugger, use the Test 
button at the bottom of your 
game’s main map display. 

The test interface runs your 
game while tracking turns, the 
passage title, and set variables 
at the bottom right. To see more 
details of the code, press the 
Debug View button. You can also 
test individual passages via the 
bug icon that appears when you 
mouse-over any passage, but 
remember that it’ll run without 
any variables that you might have 
set in previous passages. 
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ADD MULTIMEDIA, 
PUBLISH YOUR GAME 


ALL SINGING, 
ALL DANCING 


Twine 2 has a reputation for being 
less multimedia-friendly than 
Twine 1, which could encode images 
as part of its game file, but it’s really 
very simple to use HTML to include 
pictures, sound, and even video. 

To add pictures and join the 
long tradition of text-and-graphic 
adventure development, just 
use HTML <img> tags to display 
images and <audio> tags for sound. 

If you want to publish your game 
online, your sound and images will 
have to be hosted somewhere. In 
this tutorial, we’re going to use 
itch.io to publish our game, and it 
can host your images for you. That 
means you can just put them in the 
Same directory as your game file and 
use their file name to refer to them 
in your code, rather than a full URL. 

You can also embed YouTube 
videos, which can be effective if 
you want to add cut-scenes toa 
fantasy adventure, or interviews 
with suspects to a murder mystery. 
Just upload your video to YouTube, 
copy the embed code from 
YouTube’s Share options, and paste 
it into the Twine passage you want 
it to appear in. 


PUBLISH AND BE QUITE 
CHEERY, ACTUALLY 
The beauty of a Twine game is that 
it exists as a single HTML file that 
you can upload anywhere that you 
have a bit of web space. There are 
also free hosts that specifically 
cater to Twine developers. 
However, if you want a polished 
and professional set of tools for 
publishing and even monetising 
your games, we recommend setting 
up a free account on itch.io. 
Whether you want to distribute 
your games for free, set upa 
donation box for your fans, or 
release games commercially, 
itch.io’s tools make the job 
simple. You can upload blogs, 


feature 


Embed multimedia 
using HCIDL 


HTML code can be placed anywhere within a passage. 


Embed and centre an image: 
<center><img src="yourimage.jpg"; alt="victory 
gate"></center> 


Embed a sound file: 
<audio src="youraudiofile.mp3"; autoplay> 


Embed a YouTube video: 

<iframe width="560" height="315" 
src="yourYouTubevideoURL" frameborder="0" 
allowfullscreen></iframe> 


Or use YouTube’s share and embed options to 
automatically generate the correct code. 


Itch.io provides free tools to 
publish, market, and even 
monetise your own games 


screenshots and videos to keep 
players up-to-date, it’s ad-free, 
and it can even handle VAT MOSS 
payments on your profits for you. 

Once you’ve created an account, 
go to My Dashboard and hit 
‘Create new project’. From there, 
all you have to do is enter a title, 
a description, a cover image, and 
upload the HTML file. 

Remember to tick the ‘This file 
will be played in the browser’ 
box, and then enable the ‘Mobile 
friendly’, fullscreen, and scrollbars 
options further down the page. 

If you have graphics or audio 
that you want to include, just 
put them in a directory with your 
HTML file, which has to be called 
index.html, zip the whole thing 
up, and upload the zip file. 

You can preview the game’s 
page as a draft version to make 
sure everything works properly 
before you hit Publish to release 
your masterpiece. 


= 
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¢ Raspberry Pi 
¢ Python 


¢ Some ideas 


and code your own RPG maze game. The aim of the 
game will be to collect objects and escape from a 
house, making sure to avoid all the monsters. 
This project teaches game design through the 
development of an RPG maze game. In this game, 
the player has to pick up objects within a house 
and get to a specific room, while avoiding monsters 
lurking in some of the rooms. This game will be 
AD DV E N U RE This is a very basic RPG game that only has two 
rooms. Figure 1 shows a map of the basic game. 
BO CHOD Choose File > Save and save the code as rpg. py. 
il Pp Click the Run icon to test out the code. You can type 
go south to move from the hall to the kitchen, and 
. ; : then go north to go back to the hall again! Type 
Coding a text adventure Is a classic Way go west in the hall and you’ll get a friendly error 
to learn programming. Discover how to ™Ss@8e: “You can't go that way: 
: Click Stop and look at this part of the code: 
make your own adventure in Python 
@3. showInstructions(): 
04. #print a main menu and the commands 
@5. Cm 
66. RPG Game 
07. Each room is a dictionary, and rooms are linked 
@8. Commands: together using directions. Let’s add a dining room to 
69. go [direction] your map, to the east of the hall (as shown in Figure 2). 
10. get [item] 


feature ~~ 
achieved by manipulating dictionaries and lists. 
Start by opening up Thonny (Programming > 
rpq.py magpi.cc/2jbnPol 
01. #!/bin/python3 
11 B ted ) 
2. 


< “—, o =, ow that you’ve learned how to design and 
» & a build a text adventure, it’s time to learn to 
e. | - code your own. In this project, you’ll design 
Thonny Python IDE) and enter the code from rpg. py. 
@2. 
1. showStatus(): 


14. #print the player's current status 

iS. 

16. (‘You are in the ' + currentRoom) 
a7. #print the current inventory 


18. ("Inventory : + (inventory) ) 

19. #print an item if there is one 

20. if “item” in rooms[currentRoom]: 

21. (‘You see a ‘ + rooms[currentRoom][ ‘item’ ]) 
22. . 
23. 
24. #an inventory, which is initially empty 

25. inventory = [] 

26. 

27. #a dictionary linking a room to other rooms 
28. rooms = { 

29, 


Map of the basic game 
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Dining Room 


Figure 2 Now we've added a third room to the game 


You need to add a third room, called Dining Room. 
You also need to link it to the hall to the west. In 
addition, you need to add data to the hall, so that 
you can move to the dining room to the east. 


#a dictionary linking a room to other room 

positions 

rooms = { 

"Hall" : { ‘south’ 
‘east ' 


bs 


"Kitchen', 
"Dining Room’, 


"Kitchen’ : { ‘north’ ‘Hall’, 


hs 


‘Dining Room’ 


} 


>: { ‘west’ ‘Hall’, 


Try out the game with your new dining room. You 
can now go east and go west between the hall and 
dining room. If you can’t move in and out of the dining 
room, just check that you added all of the code above 
(including the extra comma after the Kitchen section 
of the code). 


ADDING ITEMS 


Adding an item into a room is easy: you can just add it 
to aroom’s dictionary. Let’s put a key in the hall. 


#a dictionary linking a room to other room 

positions 

rooms = { 

"Hall' : { ‘south’ 
‘east ' 
‘item' 


}; 


"Kitchen', 
"Dining Room', 
"key' 
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33. 
34. 
35. 
36. 
37. 
38. 
39. 
40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
50. 
D1. 
D2. 
53. 
54. 
55. 
56. 
57. 
58. 
59. 
60. 
61. 
62. 
63. 
64. 
65. 
66. 
67. 
68. 
69. 
70. 
71. 


72. 


73. 
74. 
75. 
76. 
77. 
78. 
79. 
80. 
81. 
82. 
83. 


: { 
} 
} 
#start the player in the Hall 
currentRoom 
showInstructions() 


#loop forever 


showStatus() 


#get the player's next ‘move' 

#.split() breaks it up into an list array 
#eg typing ‘go east' would give the list: 
#['"go', ‘east’ | 


move 
while move : 

move = input( ) 
move = move.lower().split() 


#if they type ‘go' first 
move[ 0] : 
#check that they are allowed wherever they want to go 
move[ i] rooms[currentRoom] : 
#set the current room to the new room 
currentRoom = rooms[currentRoom][move[ i] ] 
#there is no door (link) to the new room 


eink ) 


#if they type ‘get' first 
move|[ @ | : 
#if the room contains an item, and the item is the 
one they want to get 
rooms[currentRoom] 
rooms[ currentRoom] [ A 
#add the item to their inventory 
inventory [move[1] ] 
#display a helpful message 
print(move[1] ) 
#delete the item from the room 
rooms[ currentRoom] [ ] 
#otherwise, if the item isn't there to get 


move[ 1] 


#tell them they can't get it 
print( move[ i] ) 
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feature 


rpa-finished.py 
001. 

002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
Q20. 
@21. 
@22. 
Q23. 
@24. 
@25. 
Q26. 
Q27. 
028. 
@29. 
030. 
Q31. 
Q32. 
Q33. 
034. 
Q35. 
036. 
037. 
038. 
Q39. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
Q50. 
Q51. 
Q52. 
Q53. 
Q54. 
Q55. 
Q56. 
057. 
058. 
Q59. 
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#!/bin/python3 


showInstructions(): 
#print a main menu and the commands 


ai 
RPG Game 


Get to the Garden with a key and a potion 
Avoid the monsters! 


Commands: 
go [direction] 
get [item] 
ae) 


showStatus(): 
#print the player's current status 
Ce ») 
("You are in the ' + currentRoom) 
#print the current inventory 
("Inventory : " + (inventory) ) 
#print an item if there is one 
if “item” in rooms[currentRoom]: 
("You see a '' 


) 


#an inventory, which is initially empty 
inventory = [] 


#a dictionary linking a room to other room positions 


rooms = { 


"Hall' : { ‘south' : ‘Kitchen’, 


‘east’ : ‘Dining Room', 
‘item’ : ‘key’ 


bs 


‘Kitchen’ : { 'north' : ‘Hall’, 


"item' : ‘monster' 


hs 


‘Dining Room' : { ‘west’ : ‘Hall’, 


‘south’ : 'Garden', 
‘item' : ‘potion' 


bs 


‘Garden’ : { ‘north’ : ‘Dining Room' 


} 


#start the player in the Hall 
currentRoom = ‘Hall’ 


() 


#loop forever 
while True: 
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+ rooms[currentRoom][ ‘item’ ]) 


Remember to put a comma after the line above the 
new item (after ‘Dining Room’ here), or your program 
won’t run. 

If you run your game after adding the code above, 
you can now See a key in the hall, and you can even 
pick it up (by typing get key), which adds it to 
your inventory. 


ADD ENEMIES 


This game is too easy! Let’s add enemies to some 
rooms that the player must avoid. 

Adding an enemy to a room is as easy as adding 
any other item. Let’s add a hungry monster 
to the kitchen: 


You want to make sure that the game ends if the 
player enters a room with a monster in. You can do 
this with the following code, which you should add to 
the end of the game: 


This code checks whether there is an item in the 
room — and if so, whether that item is a monster. 
Notice that this code is indented, putting it in line 
with the code above it. This means that the game will 
check for a monster every time the player moves into 
a new room. 

Test out your code by going into the kitchen, which 
now contains a monster. Type go south and you will 
see ‘A monster has got you... GAME OVER!’ 


Ce n—Oo————————————eeeeeep 
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CODE A TEXT ADVENTURE IN PYTHON 


showStatus() 
062. 

063. #get the player's next ‘move' 

064. #.split() breaks it up into an list array 
065. #eg typing ‘go east' would give the list: 
066. #['go','east' ] 

067. move 


068. move : 
Q69. move = input( ) 
070. 
071. move = move.lower().split() 
Q72. 
073.  #if they type ‘go' first 
074. move[ 0] : 
Bernal nee er Gur adventure game 075. #check that they are allowed wherever they want to go 
Q76. move[1] rooms[ currentRoom] : 
077. #set the current room to the new room 
078. currentRoom = rooms[currentRoom][move[1] ] 
WINNING THE GAME @79. #there is no door (link) to the new room 
Let’s give your player a mission which needs to be 080. : 
completed to win the game. esl. print ( ) 
In this game, the player wins by getting to the oe ; 
083. #if they type ‘get' first 
garden and escaping the house. They also need to have 84. cel ; 
the key with them, and the magic potion. Figure 3 @85. #if the room contains an item, and the item is the one 


shows a map of the final game. they want to get 
First, you need to add a garden to the south of the Q86. rooms[currentRoom] move[1] 
dining room. Remember to add doors, to link to other rooms[ currentRoom] [ 1: 


rooms in the house. 087. #add the item to their inventory 
Add a potion to the dining room (or another room in 088. inventory [move[1]] 
your house). Finally, add this code to allow the player nee dae Arlee are aye 
to win the game when they get to the garden with the 991. HIglete “Lhe aa benicr com. Ehectoon 
key and the potion: @92. rooms[ currentRoom][ ] 
Q93. #otherwise, if the item isn't there to get 
# player wins if they get to the garden 994. : 
with a key and a shield @95. #tell them they can't get it 
if currentRoom == 'Garden' and 'key' in ae print( move[ 1] ) 
aecuTOry Bee Poe On oven lOny.: 098. # player loses if they enter a room with a monster 
print('You escaped the house... YOU WIN!") 999. rooms [currentRoom] 
break rooms[currentRoom] [ 1: 
10Q. print( ) 
You can see the final code in rpg-finished.py. 161. 
Finally, check your game to make sure the player 102. 


103. # player wins if they get to the garden with a key and 
a shield 

104. currentRoom inventory 

oo id inventory: 

0 eas : rint 

get potion ; 

go south ii 


can win! Enter the following commands: 


a 


You will see ‘You escaped the house... YOU WIN!’ 

Use what you’ve learnt to create your own game. 
Add lots of rooms, monsters to avoid, and items to 
collect. Remember to modify the code so that the 
player wins when they get to acertain room with some 
of the objects in their inventory. It may help you to 
sketch a map before you start coding. 
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only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff ” Mii @ 
agri 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 


t 


SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 


Supported by Top University Funds 
; Stanford-StartX Fund 
ee AEF of Princeton University 


Available at: 
no 
BuildPiper.com amazon ys$qu BARNES <cNOBLE 


Waker 
days 


Level 
up your 


Raspberry Pi 


Monster Joysticks 


. 7 


DELUXE ARCADE CONTROLLER KIT 


DELUXE ARCADE 
CONTROLLER KIT 


PICADE 
CONSOLE 


The product 
that launched 
Pimoroni is 
very similar to 
the Monster 
Joysticks 
version, 
although it 
has a slightly 
nicer case. 


£90 / $120 
magpi.cc/2i1H82R 
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Rob Zwetsloot builds a mini arcade machine with this all-in-one 
controller kit from Monster Joysticks 


n the last issue of The MagPi 
we took you through a 
comprehensive arcade 
machine build, including a complete 
wooden build of the cabinet itself. 
While it’s certainly impressive, 
not everyone has the space, time, 
or money for one. This is where 
awesome little kits like this one 
from Monster Joysticks come in. 
You’ve probably seen this type 
of kit before — it’s an all-in- 
one arcade joystick and case for 
your Raspberry Pi that turns it 
into a small and portable arcade 
machine. Just hook it up to the 
nearest television and you’re ready 
for some Elevator Action. It’s like 
the plug-and-play mini Mega 
Drive you got for Christmas a few 
years ago, or the SNES Classic Mini 
you missed out on this year due to 
limited stock. Thanks, Nintendo. 


Unlike the stocking filler 
plug-and-play consoles, this kit 
requires you to build your gaming 
system and supply the Raspberry 
Pi that powers it. Construction is 
very Simple, though: there are six 
acrylic panels for each side of the 
box and only eight screws required 
to fasten them all together. 


Quality components 
The kit comes with nine genuine 
Sanwa arcade buttons and a Sanwa 
joystick, which just simply click 
into the acrylic panels as you 
build them. 

To wire up the buttons and 
joystick, a little add-on board 
is provided with colour-coded 
wires. They can be a little 
tricky to properly attach to the 
connections as the connectors 
themselves are a bit tight, 


but you don’t have to worry 
too much about wires getting 
tangled up. You may also need 
to push down the top panela 
bit due to resistance of all the 
wires, but otherwise it all fits 
fairly neatly inside. You can find 
the full build instructions on 
the Monster Joysticks website: 
magpi.cc/2131Qp8. 

The build took us just shy 
of three episodes of The Simpsons, 
so make sure you set aside about 
an hour for the job. Our only 
real complaint about the build 
is that, while all the ports and 
even SD card slot are readily 
accessible, the Raspberry Pi 
can only be removed by taking 
the case apart. It will only take 
a couple of minutes to remove 
it, but we’d have preferred it to 
be a little easier. 
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The final part of the build 


involves attaching little rubber feet 


to the bottom — very welcome, as 
the case had been slipping a bit on 
the glass table it had been built on. 
The stick feels solid and has a 
decent weight to it thanks to the 
included components, so you feel 
pretty safe giving the buttons and 
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customised: the version that comes 
with the kit has square four-way 
gates, but they can be upgraded to 
an octagonal eight-way gate, or 
any other gate style if you prefer. 


Quick configuration 
Software customisation for 
RetroPie is also very simple. 


The stick feels solid and has a 
decent weight to it thanks to 
the included components 


joystick a proper workout. The 
included Sanwa components are 
quite important as not only are 
they high-quality and can survive 
a bit of classic Street Fighter 
button mashing/frame-perfect 
combo-timing, they’re also quite 
customisable. For instance, if 
you don’t fancy the button colour 
scheme, you can always swap them 
out. The joystick itself can also be 
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With a custom add-on board to 
connect the controls to the Pi over 
GPIO, we initially feared we’d have 
to download custom scripts for the 
job. Not so, though, and while you 
do need to go into the RetroPie 
configuration menu and install 

an extra driver (snesdev), it’s all 
quick and included in the RetroPie 
archive. Once that’s done, you 

can configure the stick controls, 
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as well as any extra controllers 
you’ve plugged into the USB ports. 
Co-op Contra, anyone? 

This kit is a great, solid package 
and it looks good as well. We 
recommend investing in some 
nice, long HDMI and USB cables 
to power the box and don’t be 
afraid to put some sticks ora 
little custom decal onto the case 
as well. With Christmas coming 
up, it may just be the perfect gift 
for someone, especially if they 
missed out on the aforementioned 
SNES Mini. 


A great little kit. It's a fun 
build but also a good 
quality product to use. We'd 
prefer the Raspberry Pi to 


be a bit more accessible, 
but otherwise the high 
customisability is a big plus. 


KKK 
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KITS FOR 


CHRISTMAS 


We look at some Raspberry Pi kits that are perfect for the holiday season 


The 
perfect 
stocking 
filler for 
any geek 
with an 
interest in 
electronics 


and the Pi 
The Pi Hut 


3D XMAS 


Rob Zwetsloot starts Christmas 
decorating with this fun add-on 


for the Raspberry Pi 


f you watched our video 

on the Pimoroni Unicorn 

HAT HD (youtu.be/ 
b4ItGer9qio) a little while back, 
or keep an eye on our Twitter feed, 
you’ll know that our features 
editor Rob was using the Unicorn 
HAT HD to count down toa 
forthcoming holiday. Now that’s 
been and gone, it’s time to replace 
it with something else and what 
better than a little festive add-on 
for the Christmas season? 

The 3D Xmas Tree acts very 
much like a HAT for the Raspberry 
Pi, sitting neatly on top of the 
GPIO pins. However, it doesn’t 
cover the top of the Pi and, due 
to the ‘3D’ nature of the design, 
it also hangs off the edge. Still 
though, it’s neat to just slot on. 

The £12 price is for the 
unsoldered version which you need 
to assemble yourself, but there is 
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Digital 
Soldering 
Station 


also a £15 (S20) version that comes 
pre-soldered. We’re always up for 
a bit of soldering, so were happy 
to get a soldering iron out when 
the unsoldered version arrived. 
However, due to the nature of the 
tree, it’s a little bit of a chore. 25 
resistors and 25 LEDs need to be 
individually soldered to the board 
along with a 40-pin GPIO header 
and, while it’s perfectly fine and 
pretty easy, the repetition is 
noticeable. Still, we constructed 
the tree in about 45 minutes or so. 
Programming the tree isa 
doddle and makes good use of 
the LED and LEDBoard classes 
in the GPIO Zero Python library 
on the Raspberry Pi rather than 
using its own dedicated software. 
The example code on The Pi Hut 
product page (magpi.cc/2iZCkel) 
is enough to get you started and 
you can easily modify it to make 
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your own little light routine with 


some quick tinkering. 

We like this kit as it looks great 
once finished and it’s pretty 
customisable as well: don’t want 
all the main LEDs to be red? 
Remove them and add some 
multicoloured alternatives! For 
now, though, we’re just going to 
have the standard red LEDs flash 
at our desk while we work. Maybe 
next year. 


A great little Pi-themed 
decoration that can fit almost 
anywhere you want it to. 

We suggest spending a bit 


more on the pre-soldered 
version, though. 


KKK K 
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THE OFFICIAL 
RASPBERRY PI 


The latest edition of our Projects Book is out and comes 
with 200 pages packed with awesome projects, amazing 
guides, and very helpful product reviews. We think it's 

a perfect little book for newcomers to Raspberry Pi or 
people wanting to learn a bit more about making. At the 
very least, it should keep the younger computer whizzes 
occupied until a more reasonable present-opening hour. 
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KITS FOR CHRISTMAS 


While not Raspberry Pi-powered, these adorable wearables from Pimoroni 
can be a first step into electronics for someone more on the crafting side 
of the maker spectrum. They can be easily sewn onto fabric and can even 
use conductive thread to attach sensors as well. The base can then be 
customised to suit someone's individual style — a fun little project during 
the afternoon. You can also hack them if you know how... 


STARTER KIT 


A perfect little kit for someone that asked for a Raspberry Pi for Christmas. 
This kit includes a Raspberry Pi Zero W along with a case and a Blinkt! LED 
strip, so you can get started doing cool stuff with your new Pi Zero straight 
away! It’s also a pretty small case, so it’s easy to hide for a big surprise. 
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RASPBERRY PI 
BESTSELLERS 


Books which probe and question this internet 
that we've all begun to take for granted. 


PROGRAM OR 


BE PROGRAMMED _ — 


Author: Douglas Rushkoff pROGRA M 

Publisher: OR Books 2 BE 

Price: £10 ia ocr AMMED 

ISBN: 978-1935928157 euatano® 

magpi.cc/2zqLQiS re 4 picaital Ae 
Fis 


Still essential reading, Rushkoff's 
2010 call for everyone to learn 
programming was part of a wave 
that led to Code Club and the 

Pi, and the arguments are well 
worth revisiting. 


HACKING POLITICS 


Authors: David Moon, 
Patrick Ruffini, 
David Segal 

Publisher: OR Books 

Price: £20 

ISBN: 978-1939293046 

magpi.cc/2zr6q2y 


Hackine pplitics 


The extraordinary story of the 
2012 internet blackout, and the 
successful campaign to stop 
SOPA, which would have removed 
numerous domains from the 
internet, told in the collective 
voices of those involved. 


SPLINTERNET 


ee 
Author: Scott Malcomson nee TT _—_———— 
Publisher: OR Books TE R! NET 
Price: £13 gPLIN 
ISBN: 978-1682190302 vf 
magpi.cc/2zqn3v5 14 N i 
1 | = 
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“A contested, protean terrain, 
constantly evolving as different 
forces intervene to drive it 
forward.” The internet's (military) 
history, and fragmented present Pr cdl | 
- driven by politics, money, and 

conflicting idealism (hacktivists 

versus netizens). ; 
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ADVENTURES IN 
RASPBERRY PI 
— 38RD EDITION 


Author: Carrie Anne Philbin 
Publisher: Wiley 

Price: £20.99 

ISBN: 978-1119269069 
magpi.cc/2zt24rO 


New to Raspberry Pie 
Want your children 
to learn coding and 
have fun connecting 
up lights, sensors, or even 
marshmallows? Or even use the Pi 
to make a dedicated device? You’ve 
come the right place. Philbin 

is a technology educator with 
plenty of experience of bringing 
alive the Pi’s possibilities for a 
young audience. 

After setting up the Pi, and 
learning some command-line 
basics, readers get to try using the 
Scratch programming language 
to animate a monkey sprite, then 
start building a role-playing game, 


HIGH PERFORMANCE 


SPAR 


Authors: Holden Karau 

& Rachel Warren 
Publisher: O'Reilly 
Price: £31.99 
ISBN: 978-1491943205 
magpi.cc/2yg93CX 


Apache Spark is a great 
tool for querying large 
data sets, but doesn’t it need 

big hardware to run on? In fact, 

in The MagPi #38, Sung-Taek Kim 
extolled the virtues of a small 
Raspberry Pi cluster for learning 
and experimenting with Spark, in 
an article that highlighted a typical 
data science stack of Python-based 
NumPy, SciPy, and Scikit-Learn, as 
well as Java. 

Sung-Taek also mentioned the 
importance of learning a little 
Scala, and it is that language 
that Karau and Warren propose 
as the best way to work with 
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before diving into Turtle graphics 
to make shapes with both Scratch 
and Python. Sonic Pi continues the 
coding — making music with Ruby 
code. Throughout these divergent 
adventures, additional 
notes, definitions, and 
tips and tricks combine 
with the lessons to 
more broadly educate 
new programmers. 
The last chapters are 
on hardware: using the 
wee GPIO with those sensors 
and marshmallows, and 
building a Pi jukebox. Readers who 
already have the second edition 
(see The MagPi #32) will want to 
know what’s new — a whole extra 
chapter on experimenting with 
cameras, and expanding your Pi’s 
capabilities with add-on HATs — 
but won’t need any persuasion 
to buy extra copies as Christmas 
presents for young relatives! 


Score 


Spark — although Python is not 

entirely forgotten here. Language 

choice justified, the authors give 

a pithy introduction to the how 
and why of Spark, and 
where it fits in the “Big 
Data Ecosystem’. 

This is a practical 
book, and the middle 
section takes the reader 
through data operations 
from loading, through 

optimised queries in 
Spark SQL, to join types, 
and transformations. After a 
chapter on working with key/value 
data, with a worked example of 
‘Goldilocks data’ showing different 
approaches and pitfalls, coverage 
extends to further languages 
Julia, R, et al.), testing, machine- 
learning libraries, and the broader 
Spark ecosystem. An insightful 
Spark introduction. 


Score 
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ALGORITHMS AND 
NETWORKING FOR 
COMPUTER GAMES 


Authors: Jouni Smed 

& Harri Hakonen 
Publisher: Wiley 
Price: £60 
ISBN: 978-1119259763 
magpi.cc/2yjcB7h 


There’s a big leap 
from reimplementing 
a few classic arcade games 
in Pygame to designing and 
programming complex modern 
eames. It’s certainly not something 
that would fit into one book, and 
Smed and Hakonen are concerned 
here only with the computer science 
side of game programming — in 
particular practical algorithms, and 
solving network-related problems. 
More than 70 algorithms are 
presented, covering random 
numbers, noise in data (a realistic 
world is full of imperfections), 
procedural generation, 
tournaments, game trees, path 
finding, group movement, decision 


AFTER THE 
INT CRNGL 


Author: Ramesh Srinivasan ae ol — 
& Adam Fish fe 

Publisher: Polity 

Price: £14.99 


ISBN: 978-1509506170 
magpi.cc/2ygyvrM 


What is the internet? 
A means of connecting people 
around the world, empowering 
them to better things, and 
spreading enlightenment? A way 
of monitoring citizens’ every 
activity® An echo chamber of 
sterile non-debate, and opinions 
repeated unquestioned: A means of 
monetising every click you make, 
as the so-called sharing economy 
concentrates power and wealth in 
the hands of a few platforms? 
Srinivasan and Fish tackle head 
on the gloomier prognostications 
of other commentators and 
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Algorithms and 
. Networking 
LoMmpuler Garnyee 


making, and modelling uncertainty 
— as well as networking problems, 
including dealing with cheating. 
The exercises at the end of each 
chapter range from simple 


Braben and Bell’s name- 
generation algorithm from 
Elite (1984). 

The gaming landscape has 
changed massively since the 
first edition was published in 
2006, in particular with the 
move to online and social 
gaming, but most of the underlying 
problems remain the same — so 
while exercises and examples 
change, the algorithms remain. 
You’ll need to be comfortable with 
algorithms and data structures to 
tackle the book (see The MagPi #45 
and #62 for our recommendations), 
but use of pseudocode throughout 
ensures the book works equally 
well for C, C++, Java, Python, 
or even C# programmers. 


Score 


sociologists, whilst tackling some 
of the utopic myths of the internet. 
The language is academic — and 
that of the sociologist, not the CS 


department — so if talk of post- 
Structuralists, semantics, and 
semiotics is not your cup of tea, 
you may take a few pages to settle 
in. It’s worth persisting, though 
— despite clearing the grounds of 
myths, the authors discover many 
signs of hope in the contested space 
of what makes up the internet. 
Ignoring both the techno- 
utopians, and the doom-mon¢gers, 
gives a clearer view. From grassroots 
liberation struggles to a platform 
for whistleblowers, After the 
Internet chronicles successes and 
failures in struggles for justice 
and equality, and points towards 
the internet as an assemblage of 
transformative movements. 


Score 


thought exercises to studying 


ESSENTIAL READING: 
BEYOND FUNCTIONAL 


There's more to functional programming 
than recursive functions, immutable 
data, and homoiconicity. 


Functional Programming inR 


Author: Thomas Mailund 
Publisher: Apress 

Price: £14.99 

ISBN: 978-1484227459 
magpi.cc/2yhPN8f 


Much more than just a tool for statisticians, 
R is surprisingly well suited to function 
composition and immutable data. 


The Little Elixir 
& OTP Guidebook 


Author: Benjamin Tan Wei Hao 
Publisher: Manning 

Price: £21.99 

ISBN: 978-1633430112 
magpi.cc/2ygXVpv 


relia O1P 


Fault tolerance, supervision, and 
distribution —- what more can we 
say? How about property-based 
and concurrency testing? 


Thinking Functionally 

with Haskell 

Author: Richard Bird 

Publisher: Cambridge University Press 
Price: £35.99 


THINKING 4 


ISBN: 978-1107452640 FUNCTIONALLY 
magpi.cc/2ygY3Fv with 


HASKELL 
A strongly mathematical way of ts 


looking at functional programming 
- opinionated but excellent stuff. 


Functional and Reactive 
Domain Modeling 

Author: Debasish Ghosh 
Publisher: Manning 

Price: £42 

ISBN: 978-1617292248 
magpi.cc/2ygY240 


Domain-driven design with real-world 
functional programming —- Scala and Akka - 
and the resilience and elasticity of reactive 
principles. Insightful. 


Type-Driven Development 
with Idris 


Author: Edwin Brady 
Publisher: Manning 
Price: £35 

ISBN: 978-1617293023 
magpi.cc/2ygPydo 


Safer code without depending on unit 
tests? This practical book will get you to 
truly appreciate type-driven techniques. 
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INTERVIEW 


TQ TOGO WITH PI 


Dominique Laloux has spent five years helping set up educational computer labs in 
the African nation of Togo. Here’s how he’s done it and how you can help 


ne of the key factors of Africa: two in small villages located Togo in preparation for a project 
the Raspberry Pi is its low in the hilly region of Kuma, the (completely unrelated to ICT), I met 
price. This enables less third one in the nearby town a small group of colleagues in the 
affluent people to getinonthenew _ of Kpalimeé.The first one is set small village of Kuma Tokpli. 
computing revolution, whether up in the village of Kuma Tokpli, During a long, informal 
in the UK or in poorer nations like for the benefit of students and conversation, one experienced 
Togo. Brussels computer science teachers of middle and high schools _ French and history teacher told me: 
teacher Dominique Laloux has in surrounding villages. The two “T feel like a 21st century illiterate 
been working with and helping others are set up in secondary because I cannot use a computer.” 
the Togolese to bring computing schools. Our first lab was a rather That statement impressed me very 
education to schools and has made ‘conventional’ computer lab, set much, and I decided to challenge 
eood use of the Pi in this effort. up with ‘retired’ laptop computers. him by offering to send a few 
The two others are Raspberry Pi computers along, on the condition 
Can you tell us about the computer labs: each of their 20+ that he promised me to learn how 
eee educational work you do in Togo: workstations is a Pi. The original to use them. 
training is Since 2012, some Togolese friends lab will soon be updated to include He probably thought I was not 
set Reva oot and I have set up three computer Raspberry Pis. serious about that offer, but a 
learn properly labs in rural areas in Togo, West Our efforts now tend towards two few months later I had collected, 
main objectives: to set up one new refurbished, tested, and packed 
Raspberry Pi in one middle/high enough equipment to set up a fully 
school every year, and to promote functional computer lab with 25 
the use of the Raspberry Pi as an computers, a network printer, a 
alternative to more ‘conventional’ projector, a whiteboard, etc. 
computers in schools and other I went back to Kuma a couple 
educational communities in Togo of times and, by October 2012 we 


and anywhere resources are scarce. | were ready to install a small local 

construction with proper electrical 
How did the idea come about? wiring, a local area network, and 
In 2011, while I was visiting the 25 workstations. We started 
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¢ Proper size room (7 « 11 
metres typical classroom): 
must be clean, dry, 
ventilated, well protected 
against insects/rodents 
and, of course, protected 
against intrusions. 


Electrical wiring: recent 
and well protected, 
with differentials, 
circuit breakers, cable 
ducting along the walls, 
no cables on the floor 
around workstations. 


Local area network, 
including a switch (100 Mb + 
1 Gigabit port). 


Ideally 20 or more Raspberry 


workstations, plus one for 
the teacher. 


A local server, which can 
simply be a faster laptop, 
working as a file server, a 
web server, or Kiwix. 


Accessories: network 
printer, scanners, video 
projector, etc. 


Whiteboard rather than 
chalk (to avoid dust) - a flip 
chart can be sufficient. 


ICT-related posters 
to illustrate important 
concepts/decorate. 


Avery broad collection 

of applications including 
LibreOffice, Firefox, 
Chromium, Gimp, Audacity, 
GanttProject, FreePlane, 
GnuCash, some music 
composition software, 
scanning tools, games, 
utility programs, etc. 
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training teachers the week after. No 
school, no village, no community in 
the entire region had ever had such 
a ICT facility at their disposal. 

2012 is also the year the first 
Raspberry Pi was introduced and 
I was lucky to get one of the very 
first units available in Belgium. I 
immediately made the link with our 
small action in Togo. 

In 2013, I was offered a full year 
sabbatical by my employer, in order 
to be able to focus exclusively on 
what had become a not-for-profit 
project — the ‘Centre Informatique 
de Kuma’ (Kuma Computer Centre). 

During that year, it became 
obvious that it would be best to 
have a second computer lab, located 
in the nearby village of Kuma 
Adamé, in order to make it possible 
for students to benefit from an 
introduction to ICT while avoiding 
the dangers of walking the path 
between the two villages 

In Summer 2014, we opened our 
second lab in Kuma Adamé - the 
first Raspberry Pi computer lab 
in Togo — for the benefit of about 
200 young students and their 
Sevemilcacwcns: 


Why the Raspberry Pi: 

Three aspects of the Raspberry Pi 
make it a very serious alternative to 
more ‘conventional’ computers in 
developing countries or in any place 
where resources for education are 
scarce (including in my country!): 
low cost, low power requirements, 
low maintenance. 

One must consider an often 
forgotten aspect of computer 
donations to developing countries: 
what is initially a kind gesture 
can easily turn into a ‘poisoned 
gift’. Older, ‘retired’ computers 
are inevitably likely to break down 
after a while. In a developing 
country where resources are 
scarce, it can then be difficult and 
expensive to repair them (spare 
parts are difficult to find and often 
expensive; technical skills are not 
always available...). Such machines 
are also often relatively more 
“power hungry’. 


lh 


Above Work 


What can go wrong with the 
Raspberry Pi setup° A computer 
screen going bad? An input device 
that stops working? A damaged 
SD card? None of these is really an 
expensive problem. We’ve got very 
nice second-hand 17-inch computer 
screens for about €5 a piece; nearly 
new keyboards and mice (discarded 
by companies) for less than €4 each. 

The most expensive failure? One 
of the computers that fails and 
must be replaced. That would cost 
exactly €35. In fact, we have a small 
reserve of several Raspberry Pias a 
backup: in nearly four years, we’ve 
never had to use one! 


has to go into 
making sure the 
classrooms are 
ready to be used 


How have students reacted to 

the classes? 

They simply love it! Most of them 
quickly take ownership of their 

ICT education. And some are eager 
to move much further than the 
simple use of ICT, dreaming about 
getting engaged in maintenance, 
programming, and other IT-related 
higher education. And, in the small 
eroups | have worked with since 
2012 in Kuma Tokpli, some of them 
actually have reached a level where 
they can consider such a path for 
their higher education. 


Want to aid Dominique and his friends in their 
efforts? Head to initic.be to find out how you can 


support them with equipment, money, or your own 
personal time and labour. 


— 
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YOUR ARCADES 


Last month we told you how to 
build an arcade machine. Here 
are some you've already created 


t the end of issue 63’s arcade build feature, we rT 

showed off some of the alternative arcades 

you could try. Unfortunately, we didn’t have 
space to show all of them, so here are some of the best 
arcade machines from around the community. 


Not content with making one arcade machine, 
Circuitbeard (Matt Brailsford) has made multiple 
amazing custom Raspberry Pi arcades. Each of them eee | ot Baer ‘ 
has had a ridiculous level of work put into it, so we’re oes ‘- IRA V4 The Rombus-CT is a 


a 8 hand-built two-player 
going to show off three of his incredible creations here. + nae ade einer 


3 =.” e 
An old Grandstand Scramble desktop . . | g == s— Playing games on it is easy, 


arcade machine was repurposed to - Pee and Circuitbeard even 
make this mini Pi arcade a eS connected a keyboard to it 
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Arcade cabinets are not just for arcade games! 
This custom Legend of Zelda build themed around 
Ocarina of Time is a beautiful thing, its style 
reminding us more of pinball table than the kind 
of arcade machines you normally see. Of course, 
you can still play arcade games on here, but you 
can also play Link to the Past. 


This arcade machine actually uses a 4:3 monitor, 
much more accurate for classic coin-op games 


Donkey Kong is one of the all-time classic arcade games, 
introducing video game superstar Mario to the world, as well as the 
titular Donkey Kong himself. This excellent build takes an old wine This cabinet wes hand- 
barrel that looks like the kind the big gorilla chucks at you, and Matt built, the wood stained and 

+7: painted, and vinyl graphics 
has installed a control system and screen so it can be used a bit like a applied to the Surface 
cocktail arcade table. 


With new decals, it’s properly 
branded to the arcade classic. For 
more details on the build, see the 
project showcase in this issue 


An inspired build sees a classic kids’ toy 
repurposed as a mini Out Run cabinet. It 
uses up a lot less space than the real thing 
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BIG BIRTHDAY 
WEEKEND? 


The Raspberry Pi Foundation wants to put ona 


global celebration for its sixth birthday. “RASPBERRY 


Here’s how you can help 


or the past few years, the Raspberry Pi 

Foundation has held a community event in 

Cambridge around Raspberry Pi’s birthday, 
where people have come together for a huge party 
with talks, workshops, and more. Now they want 
more people to have the chance to join in with the 
birthday celebrations next year, so they’re going to 
be coordinating Raspberry Jams all over the world 
to take place over the Raspberry Jam Big Birthday 
Weekend, 3-4 March 2018. Already registered? Here’s . 
what you need to do next. aS Ve os 


What do you need to do? 


At this point, you should be looking for a venue, and 
aiming to book the date as soon as possible. Don’t 
leave it too late, or you might have difficulty securing 
a location. If you need some advice on finding 


NEED HELP 
a venue, refer to the appropriate section in the 
Guidebook (magpi.cc/2q9DHfQ). STARTIN G A J AM? 
Once you’ve done that, you should create a sign-up 
page for your event (on Eventbrite, for example). 
Then you can submit your event to the Jam map 
(magpi.cc/28Nxeff), and start to publicise it locally. 
We’re planning to produce some limited-edition 
‘tour’ T-shirts for the Big Birthday Weekend and 
we’d like to include as many Jams as possible on the 
back print. To make sure your event gets included, 
submit your Jam to the map as soon as possible. 


Stay connected 

If you’re not already a member, you might find it 
useful to join the Raspberry Jam community on Slack 
(slack.com), where Jam organisers share ideas and 
help each other. Just email jam@raspberrypi.org to 
request an invitation to join. 
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THIS MONTH IN PIL GQ UT THT 


KICKSTART TH 


Raspberry Pi projects you can crowdfund this month 


ad 
ie STAT) A. Lire cH a 
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DUAL BATTERY HAT PI/104 


Portably power your Raspberry Pi with powerful Something a bit more industrial: the Pi/104 is a 

18650 lithium-ion batteries thanks to this very Raspberry Pi Compute Module dock that allows the 
special HAT. 18650 batteries are a fair bit larger than CM to conform to the PC/104 standard. The Raspberry 
AA batteries, but can contain a lot more charge, Pi is popular in industrial automation setups and the 
which is great for when you need your Pi to stay on creator project Adam Parker believes the price allows 
for longer. It’s already hit its goal, so now is a good for prosumers to make use of it as well. Give it a look as 
time to jump on it. there’s not many products like this around. 


BEST OF THE REST 


Here are some other great things we saw this month 


= magpi.cc/ sriyleatges 


PI VENDING MACHINE ! e = 


i} 
f - 
' 


magpi.cc/2zWzlor 


PI-TAC 2.0 


TOUCHSCREEN (ie: Beeson 
300\EO< 


Retro upcycling with a Raspberry Pi 

is good fun, and we love this proper 
Eighties stereo being upgraded with 
a Raspberry Pi. Hopefully it’s portable 
so you can sling it over your shoulder 
and walk down the street with it. 
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n its tenth anniversary year, PyCon UK 

took place at Cardiff City Hall in October, 

bringing together professional Python coders, 
hobbyists, children, and educators. 

The programme was varied and packed with ideas, 
with up to nine streams running at the same time. 
Among other things, there was an introduction to 
object-oriented programming, talks on artificial 
intelligence, and tips on getting the best performance 
from Python. BBC micro:bit sessions showed how to 
code the device in MicroPython, and offered advice for 
those teaching with it. 


= 2 aN 


Mikey Lear and Luke Spademan 
test a micro:bit-controlled robot 
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On Thursday, 24 educators attended Picademy, 
the programme from the Raspberry Pi Foundation 
that supports them in digital making. Professional 
coders and hobbyists from the main conference 
dropped in to help with projects including a man 
overboard alarm, a spinning pumpkin decorator, 
and a motion-activated ghoul. 

Django Girls ran a one-day workshop to introduce 
women to programming using the Django web 
framework. Student Shuping Li took part and said: 
“The best thing was that it made me feel I was able 
to use Python despite having zero experience. I went 
from nothing to making a blog ina day.” 


Wheely good 

Ben Nuttall, Raspberry Pi Community Manager, revealed 
how the process for installing Python packages has been 
accelerated on the Raspberry Pi. ‘Wheels’ are Python 
packages that have been compiled for a particular 
architecture. They’re smaller files to download, and 
there’s no time spent compiling after you download 
them. The Python Package Index (PyPI) doesn’t support 
ARM packages, though, so Ben built his own repository, 
called piwheels. It involved compiling more than 96,000 
packages, and a total of over 670,000 version releases, 
using cloud-based Pis. If you’re using Raspbian Stretch, 
piwheels is already configured as an additional index. 
For installing a package like NumPy, it could save you 
over two hours of compilation time on a Raspberry Pi 1. 
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The first winners of 
the John Pinner Award 
collect their medals 


This PyCon introduced the John Pinner Awards, 


named in tribute to the late PyCon UK founder. 
Ten medals were awarded to recognise those 
who contribute to the Python community. The 
first recipients were Cat Lamin, Daniele Procida, 
Eléonore Mayola, Joshua Lowe, Leona So, Mary 
Mooney, Sheila Pinner, Tim Golden, Tony Ibbs, 
and Vincent Knight. Congratulations to them all! 


H H Joshua Lowe 
A jewel In the crown kicks off Code Club 
Saturday was children’s day, described by Daniele by introducing 
; net ; EduBlocks 
Procida, a member of the organising committee, as 


“one of the jewels in the crown of PyCon”’. There was 
Fiona Murray and 


a Code Club, which included a session led by Joshua Miriam Winkels 

Lowe. At 13 years old, he is the creator of EduBlocks, make a pumpkin 
; ; decorator in 

a drag-and-drop interface for programming Python Picademy 


that makes it easier to transition from Scratch. At the 
same time as the Code Club, a Raspberry Jam took 
place next door. It included an introduction to physical 
computing with the Raspberry Pi, Minecraft hacking, 
and science experiments using the Sense HAT. 


The best thing was that 1t made 
me feel I was able to use Python 
despite having zero experience 


ee 
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At the end of the day, the children presented their With over 
. : ; . 700 attendees, the 
projects to the conference in a session held in the assembly hall was 


main assembly room. Pi projects included an LED often busy 


caterpillar, a game using the Python turtle module, 
and a burglar alarm. The micro:bit was used to make 
a kindness badge, a calculator, and a Morse code 
transmitter. The children shared some of their coding 
experiences from the day, too. One said: “We had to 
type out things. Type in things. Type out things. Then 
it worked!” Many of the professional coders in the 
room recognised that pattern. 

On Sunday afternoon, some attendees came 
together to see how Python can be used to help 
identify people at risk of developing Alzheimer’s 
disease. The conference ended with a day of 
programming sprints, including Trans*Code, 

a hackday dedicated to tackling issues faced by 
transgender people. 

If you missed out this year, you can catch up online. 
The schedule now includes links to presentations 
and videos, where available. Find them at 
2017.pyconuk.org/schedule. 
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COMMUNITY PROFILE 


Introducing Raspberry Pi Certified Educator, 
digital maker and all-round tech nerd, 


Lorraine Underwood 


ou just have to glance 
| at educator Lorraine 

Underwood’s Twitter 
feed to realise she’s an avid 
digital maker. From her popular 
illuminated temperature Staircase 
be) Imei Nets) ne laqolkemer Care. 
she’s forever making and sharing 
her creations. “I find Twitter a 
really positive and encouraging 
place to be. I live there!” she 
admits, going on to share that she 
tries to use her confidence with 
tech such as the Raspberry Pi to 
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“| saw someone had made a 
virtual-reality Arduino car connected by 
radio to a headset... but it was with three 
Arduinos and cost over $300. | thought to 
myself, ‘| could make that with a Pi for so 
much cheaper’ and | did!" 


ft Lorraine operates on a Babbage, 
proving that no bear is safe, even after 
the final bell of Picademy training 


encourage others who seem a little 
lost in their first steps into the 
community of makers. 


Getting started 
With a degree in Computer 
Science, you’d think Lorraine had 
all the know-how and confidence 
to be a digital maker from the 
start. But as she confesses, her 
education was 100% computer 
based, with no physical making 
aspects involved. It was only when 
she started working for Lancashire 
University that she began to 
dabble in the world of digital 
making, and then the bug bit her. 
At the university, Lorraine works 
as part of a team to help encourage 
and support primary and 
secondary teachers in bringing 
the new computing curriculum to 
their classroom. And with digital 
making projects, she’s found a 
hit for enticing dubious educators 
into the fold. “Teachers are very 
interested in physical computing 
and digital making,” she says 
when discussing the conferences 
and workshops her department 
hold for teachers based in the 
North West of the UK. “To run 
workshops that teachers were 
interested in, I had to look at what 
was out there in terms of physical 
computing and digital making.” 
Outside of the university, 
Lorraine continues to work closely 
within the field of education. She 
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teaches Computing at a girls’ 
grammar school, runs a small 
Raspberry Jam in Cumbria, and 
shares a passion for introducing 
computing and digital making 
to girls through Code Club and 
various community events. 


Full of ideas 

At home, she’s forever tinkering. 
“T just love to make things! I make 
a lot of things; some may call me 
prolific! I just get a cool idea in my 
head and go with it.” 


“A few people have tweeted their 
version of my light-up temperature- 
controlled stairs and that just blows my 
mind. | Love that I've inspired people to 
try and make things” 


Alongside the rainbow Stairs, 
Lorraine is also proud of her 
virtual-reality car, a project 
that she went on to showcase 
at Newcastle Maker Faire. 
Controlled by a Nintendo Wii 
Remote, and connected by 
radio to a VR headset, it stands 
as a testament to her love of 
tinkering and working on ideas 


I just love to make things! 
I make a lot of things; 
some may call me prolific! 


Lorraine will be well known by 
many members of the Raspberry 
Pi community for making her Pi- 
powered, temperature-controlled 
Stair lights — featured in The MagPi 
issue #58. With NeoPixels running 
along the bottom of her bannister, 
they change their colour from red 
to blue (with a rainbow of colours 
in between) depending on the 
outdoor temperature. The build 
was documented on her website 
and she’s found the response to 
be incredible, especially when 
people share their own versions 
Of the project. 
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from pre-existing projects to 
add her own twist, this time 
replacing three Arduinos with 
one Raspberry Pi. 

In her own words, Lorraine 
explains of her tutorials, builds, 
and blog: “I try to keep everything 
cheap and accessible for your 
normal person — I try not to 
solder things or do complicated 
coding. I think a lot of projects 
are amazing but are really 
complicated and out of reach 
for your average person. I try to 
make my builds simple and easy 
to follow.” 


COMPUTING IN EDUCATION 


Lorraine spreads her experience and excitement 


across many sectors of the educational scope. As 
Computing at School coordinator for Lancashire 
University, she supports both primary and secondary 
educators in delivering the new computing 


curriculum to the classroom. She runs training, 
conferences, and events throughout the North 
West, using her interest in digital making to support 
and enthuse teachers, enabling them to take 

back interesting projects to their students. She 

also teaches at Lancaster Girls’ Grammar School, 
ensuring that she practises what she preaches. 
During Thursday lunch, she runs a Code Club for 
students aged 11-14, and also dedicates some of 
her time to running Kendal Raspberry Jam once 

a month in Cumbria. “We're a small but growing 
Jam of mostly children and their parents,” she 
explains. “Our jammers like to play with stop-motion 
animation, Minecraft, and Scratch.” 
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EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


Want a Raspberry Jam in 
your area? Want to start one? 
Email Ben Nuttall about it: 
ben@raspberrypi.org 


BOGNOR REGIS 

RASPBERRY JAM 

When: Saturday 9 December 

Where: University of Chichester, 
Bognor Regis, UK 

magpi.cc/2iWjjcU 

This first Bognor Jam is primarily a 

show-and-tell event where people 


bring projects for visitors to try out. 


VALPARAISO 

RASPBERRY JAM 

When: Thursday 14 December 

Where: General Cruz #222, 
Valparaiso, Chile 

magpi.cc/2iXM601 

A Jam ina Chilean FabLab. There’s 

no schedule of events yet, but keep 

an eye on the website for more. 
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VALPARAISO 
RASPBERRY JAM 
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CORNWALL TECH JAM 
When: Saturday 9 December 
Where: Bodmin Library, 
Bodmin, UK 
cornwalltechjam.uk 
For anyone interested in 
technology, any age or ability. 
Learn about coding in Scratch, 
Python, Minecraft, and more. 


NUNEATON RASPBERRY JAM 
When: Saturday 16 December 
Where: Nuneaton Library, 
Nuneaton, UK 
magpi.cc/2iWXWsh 
Mod Minecraft Pi with some 
Christmas-themed Python 
coding. Make your Minecraft 
world truly festive! 


POTTON MINCE PI & PINTS 
When: Saturday 9 December 
Where: The Rising Sun, 

Potton, UK 
mMagpi.cc/2zJwdmB 
A Christmas-themed Pi & Pints 
event, where you have fun 
with Raspberry Pi in a relaxed, 
social atmosphere. 


COFFEE, CAKE AND CODING 
When: Thursday 7 December 
Where: King Edward VI Sheldon 
Heath Academy, 
Sheldon, UK 
magpi.cc/2zMcJh6 
Learn good coding practice ina 
relaxed and informal setting while 
enjoying coffee and cake. 
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WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 


NUNEATON : 
RASPBERRY JAM ¥ 


P| TOWERS 
RASPBERRY JAM 
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eee RASPBERRY JAM ADVICE 
PLANNING THE EVENT 


Cambridge, UK 
magpi.cc/2ZKYo4L 
A family-friendly event where 
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everyone is welcome. Coding “We use the Eventbrite app to check in attendees A Ae & ~~ 

and digital making activities will where possible. However, people tend to arrive la ° & = 

be provided. all at once and we don't like a queue. If it’s not “e oe MY : = 
possible to scan the tickets, we just check them i OY 

TORBAY TECH JAM as they come in. It means our numbers are a little & © 

When: Saturday 9 December off, but it keeps people happier.” ala 

Where: Paignton Library, Michael Horne hs 


bd RASPBERRY & 
@ JAN : 


SUIDEBOQ, 


Paignton, UK CamJam 
torbaytechjam.org.uk 
This Jam is designed to be 
a fun, informal, and family- 
friendly event, for all ages 
and experience levels. 


Every Raspberry Jam is entitled to apply for a Jam 
Starter kit, which includes magazine issues, printed 
worksheets, stickers, flyers, and more. Get the book oRDM Tha 
here: magpi.cc/2q9DHfQ. - 


LETTERS 


piopDASHADARD 


Monitors of green 

Whenever I see pictures get posted from official 
Raspberry Pi events like a Picademy or something 
similar, I always see these wonderfully vibrant 
bright green monitors that are used. Where do 
those monitors come from? Are they some kind of 


official Raspberry Pi monitor? I’d love to get one! 
Frank Reid 


CEEDuniverse 


They are very iconic monitors, aren’t they? They’ re Sta, 
not official Raspberry Pi products; in fact, they’re : _ 
actually pi-topCEEDs. These are the cut-down Gn. ee 
desktop version of the pi-top laptop. They just 
include a screen, but you can still plug a Raspberry 
Pi into it — all you then need to add is a mouse 
and keyboard. They are also readily available for 
purchase; check out more details on them here: 
magpi.cc/2zaTkWj. 

The CEED is used by the education 


and community team at the Raspberry Pi 
Foundation in many of their events 


Missing files 

I have a problem downloading the 
file scratch_gpio_handler.py 
from issue 10 of The MagPi. In 

the article ‘Scratch Controlling 
GPIO 2 - Birthday Pi’, there is a 
link you need to download files 
from using wget, but it doesn’t 
work. Perhaps you can help me? 
Max 


Some of the content in older 
issues of The MagPi points towards 
an old MagPi website that no 
longer exists; sorry about that. 
However, the code from the first 
30 issues of the magazine (and 
the majority of the other issues) 
can be found in our GitHub repo: 
github.com/themagpimag. 

In this instance, the correct 
files can be found here: 
magpi.cc/2jaiYU5. 

For cases like this, you just need 
to download the files manually 
from our GitHub repo, then proceed 
to the next step in the tutorial. 
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FROM THE FORUM: 


= 


The Raspberry Pi Forum is a hotbed of conversations 
and problem-solving for the community — join in via 
raspberrypi.org/forums 


You can 
now get your 
ZeroBot STLs 
from a new place 


n one of the 
more recent 
MagPi 
Essentials books 
about GPIO Zero, 
there is a reference 
to ZeroBot that was first 
presented in issue 40 of The MagPi. 
As I seem to have all the stuff needed to 
build a ZeroBot, I thought I’d do it. However, 
the link to the thing on Thingiverse is broken. 
The thing seems to have been taken down. So I - Industrial DIN rail mount 
can’t print the chassis... ; 

Does anyone know where I can find the STLs - Open frame for better airflow 
nowadays? Or is there anyone who can supply ‘ Integ rated USB strain relief 
them for me? 

Thanks in advance! 
Jonas Lorander 


You’re not the first person to ask us about this 
recently, so we thought we’d make a note of 

it here — the files for the original 3D-printed 
chassis that Richard Hayler found for that 
tutorial have mysteriously vanished from the 
internet. We did locate an alternative upload, 
but that too has gone. 

Since then, someone has been kind enough to 
upload the files to Thingiverse, and even called it 
ZeroBot for easy Google searching! You can find 
it at the link here: magpi.cc/2zWomzb. 

Unfortunately, the internet is forever 
changing and not all of it is archived properly, 
so things like this may disappear. If you ever find 
a link that no longer works, please let us know 
via email at magpi@raspberrypi.com or on the 
forum and we’|l try to help out. 


raspberrypi.org/magpi December 2017 MdgPi | 95 


@ @ code 
club 


y 
START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to runa 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


M4 Code Club is free 


4 Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


4 Code Club helps children develop skills including % 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us!" 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 GS 
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MONSTERBORG 


& THUNDERBORGS 


A beast of a kit designed to be taken off road or driven 
autonomously. It’s also the primary racing robot for Formula Pi. 


One lucky winner 
will own this robot 


The MonsterBorg can be 
programmed as a Self-driving 
robot, used for education about 
self-driving systems, or raced 
around the garden as an RC 
off-roader. It also makes a great 
platform for hacking about with 
robots by adding extra sensors 
or servos (magpi.cc/2ltc8gT). 


For a chance to win a MonsterBorg 
or one of three ThunderBorgs, you 
just need to go online and enter 
our competition. 
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Dual 5A Motor Controller 
with DC/DC & RGB LED 


Competition opens on 29 November and closes on 28 December 2017. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry 


Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the 


competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The 


MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no 


cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column | THE FINAL WORD 


digital making to educators 


aspberry Pi computers are meant to get young 
people to understand how computers work 
and to empower them with the ability to make 
things with computers. In order to do that, we make 
Raspberry Pi devices ultra-affordable and we offer 

a library of free project-based resources for getting 
started with them. But as you might already know, 

we don’t stop there. 

In 2017 alone, the Raspberry Pi Foundation has trained 
over 550 educators in digital making with Raspberry 
Pi computers at ‘Picademy’ workshops across the 
United Kingdom and the United States. These two-day, 
hands-on workshops are free for educators. On the first 
day, they learn about digital making, computer science, 
electronic circuits, and physical computing. They get the 
opportunity to try Raspberry Pi computers with Scratch, 
Python, LEDs, buttons, switches, the Camera Module, 
motors, and more. 

On the second day, the educators are challenged to 
collaborate in groups to create a project with tools and 
concepts that they learned the day before. They are 
then sent home with a kit of materials so that they 
can take Raspberry Pi and digital making back into 
their learning environment right away. 

I want to take this opportunity to point out that 
these learning environments aren’t only classrooms. 
It’s important to us that we take a broad view of what 
‘educator’ means. Picademy is not just for classroom 
teachers: it also includes librarians, museum 
educators, after-school program leaders, scout 
leaders, and makerspace educators. There are many 
opportunities for young people to learn inside and 
outside of the classroom and we want to make sure 
we’re supporting all possible pathways to learning. 

For our charity, training educators is a great way 
to have the biggest possible impact on young people 
around world. Educators know what works best for 
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MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


3 EMPOWERING 
% EDUCATORS 


Matt Richardson shares his thoughts on bringing 


those in their teaching environment. They have 

the experience to reach youngsters and get them 

to understand the concepts behind digital making. 
When we show these educators the power of digital 
making and Raspberry Pi, they can take these lessons 
and apply them the way that they see fit for the kids 
that they work with. And purely from a numbers 
perspective, if every educator we train goes on to 
teach only ten young people on average, then our 
impact is already increased by an order of magnitude. 

The Picademy experience doesn’t end with the 
workshop. Those who attend become Raspberry Pi 
Certified Educators and join a passionate community 
of digital making enthusiasts. They stay in touch, 
collaborate, share best practices, organise Raspberry 
Jams, run Code Clubs, and train other educators 
back home. 

I acknowledge that not every educator has the means 
to travel to our workshops and spend two full days 
with us. For those who aren’t able to join us in person, 
we have a Series of online courses on the FutureLearn 
platform. While these courses are geared towards 
educators, anyone can join them for free. They cover 
subjects such as physical computing, object-oriented 
programming, and teaching programming to children 
in primary school. You can join these courses here: 
magpi.cc/2h5Sthf. 

Even if you’re not an educator, you can still be 
involved in our educator training efforts. Every time 
you buy a Raspberry Pi or if you’ve subscribed to 
The MagPi, you’re supporting our objective to train 
educators who will go on to have a massive impact on 
young people. And if you’re looking for other ways 
of supporting, you can help get the word out! If you 
know an educator in your community who would be 
perfect for our training, please send them our way: 
raspberrypi.org/training. 
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Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pj board and case 


Power Supply and HDMI cable 
Pre-Programmed 
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Available in Europe 
Available for worldwide shipping at: through RS Components 


$389” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 
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